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PREFACE 


MANUAL OBJECTIVES 


The RSX-11M System Generation and Management Guide is for use in 
generating the RSX-11M operating system. This guide provides 


information on how to generate an RSX-11M system tailored to a 
particular installation's hardware configuration and application 
requirements. 


INTENDED AUDIENCE 


System generation is a fairly complicated process. To fully 
understand what is taking place, readers should be familiar with 
RSX-11M and its component tasks. This guide is directed toward system 
Managers (those responsible for tailoring and maintaining installation 
specific RSX-11M systems. 


STRUCTURE OF THIS DOCUMENT 

First, read Chapters 1, 2, and part of 3. Then follow the specific 
instructions in Chapter 3. For complete details on the Phases of 
system generation, read Chapters 5, 7, and 9. 

Chapter 1 contains an overview of the system generation process. It 
acquaints you with the various phases involved in producing a tailored 
system. 


Chapter 2 describes the distribution kits and supplies methods for 
copying the media. 


Chapter 3 provides information on preparing the host system and on 
initiating system generation. 


Chapter 4 provides a summary of the Phase I questions. 


Chapter 5 provides complete details for the Phase I questions. 


Chapter 6 provides a summary of the Phase II questions. 
Chapter 7 provides complete details for the Phase II questions. 
Chapter 8 describes the commands and operation of the Virtual Monitor 


Console Routine (VMR), which initializes the target system in the 
final stage of system generation. 


Chapter 9 describes the optional phase of system generation, Phase 
Ift. 


Chapter 10 describes the means of confirming that the system 
generation process was a success. 


Chapter 11 supplies an interpretation of the system generation error 
messages, 


Note that Chapters 5 and 7 conclude with details of an actual system 
generation (Chapter 5 contains Phase I, Chapter 7 contains Phase II). 


Appendix A defines the symbols of a saved answer file. 
Appendix B describes the system display task RMDEMO. 


Appendix C describes the Console Output Task (COT) and defines COT 
commands, 


Appendix D describes the queue manager. 


Appendix E describes the I/O Exerciser (IOX) and defines the IOX 
commands. 


Appendix F describes RSX-11M system conventions. 


Appendix G is a listing that describes the means of building a 4K FCS 
resident library. 


Appendix H describes how to use support for DEC supplied Help files. 


Appendix I details hardware bootstrap ROMs. 


ASSOCIATED DOCUMENTS 


The RSX-11M Documentation Directory briefly describes all the manuals 
in the RSX-IIM documentation set and provides a brief synopsis of each 
manual's contents. The following lists the manuals most closely 
allied to the purposes of this guide: 


RSX-11M/M-PLUS Executive Reference Manual 


RSX-11M/M-PLUS MCR Operations Manual 


RSX-11M/M-PLUS I/O Drivers Reference Manual 


RSX-11M/M-PLUS Task Builder Manual 
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CHAPTER 1 


INTRODUCTION 


The system generation process, SYSGEN, defines a_ user RSX~-11M 
operating system tailored to meet a specific PDP-11 configuration. 
SYSGEN provides the flexibility to generate an RSX-11M system that 
fits the many variations of the hardware configuration as well as the 
software elements. 


This chapter provides an introduction that helps you tailor RSX-11M to 
meet your hardware and software needs. 


1.1 OVERVIEW OF SYSTEM GENERATION 


The system generation process consists of logical steps that 
ultimately produce an RSX-11M system. Figure 1-1 summarizes these 
steps from preparation and planning, invoking the SYSGEN command 
files, creating the tailored system, and placing the system on a 
target media. 


1.1.1 Preparing for SYSGEN 


First, backup your RSX-11M distribution kit. and become familiar with 
the baseline system. The backup copy insures against destruction of 
the data on the kit and provides a base for updates to the operating 
system that you may receive in the future. The baseline system 
controls the system resources during system generation. 


Chapter 2 provides information about the distribution kits and how to 


copy the kits to a backup volume. Chapter 2 also describes the 
RSX-11M baseline system. 


1.1.2 The System Generation Command Files 

RSX-11M indirect command files control system generation. These 
command files are collectively known as SYSGEN. The SYSGEN command 
files: 


e Permit you to define the features to be included in (or 
excluded from) your system 


e Perform MACRO-11 and Task Builder processing to produce an 
executable image of the system 


e Define the system memory requirements 


QC, 
S 


Distribution Kit 


PDP-11 and Peripherals 


® [200,200] SYSGEN.CMD 


®@ Source Files , SY: 


@ Command Files 


@ Selected 
Source Files 
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@ Object Files ——) 
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Backup Backup 
Tape Volume Disk Volume 


1. Plan for system generation 
by reading documentation 
and setting up your 

hardware configuration. 


. Set.up for system 

generation: 

A. Copy the distribution 
kit. 

B. Bootstrap the baseline 
system into processor 
memory. 


Processor Memory 


Baseline 
RSX11M.SYS 


. Define your system by 
answering questions in 


SYSGEN Phase |: Fa) 
A. Invoke SYSGEN. @ Command 
Files 
‘ @ Selected 
B. Answer questions. euros Files 


C. Assemble the executive. 


@ Command 
Files 
Object Files 


4. Create a bootable image 

of your system in SYSGEN 
Phase II: 

A. Invoke SYSGEN2. 


Target Volume 


B. Task build (TKB) the 
Executive device drivers, 
and privileged tasks. 


RSX11M.TSK 


C. install your system 
tasks and set up 
Partitions using VMR. 


D. Bootstrap your system 
into processor memory, 


Figure 1-1 SYSGEN Steps Z 
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5. If necessary, create 
executable images of 
UTLOBJ nonpriv.tasks or of 
lab I/O peripherals in 
xxx.CMD SYSGEN Phase III: 
xxxX,OBJ = ® Task build nonpriv RSX11M.TSK 
or subsystem object 
module, 


xxx.CMD 
RSX11M.TSK = Install these tasks with RSX11M.SYS 


Executive and other 
system tasks using 
VMR. 


6. Ensure that your system 
runs properly by testing 
it with the Installation 
Verification Procedure. 


Figure 1-1 (Cont.) SYSGEN Steps 


SYSGEN executes in three phases or parts. In Phase I, you define the 
target configuration and assemble the Executive and device drivers. 
In Phase II, you task build the Executive, device drivers, and 
privileged system tasks. In Phase III, you optionally task build 
nonprivileged tasks. 


When SYSGEN completes processing of Phase I, it has produced object 
and command files to be used as input to SYSGEN Phase II. Upon 
completing Phase II, SYSGEN has produced a system image, complete with 
loadable drivers and privileged tasks. You can then, if necessary, 
continue with Phase III and build (or rebuild) nonprivileged tasks. 


1.2 SYSTEM GENERATION FEATURES 


The system generation dialogue is divided into phases, each phase 
designed to generate a separate section of the system: 


Phase I -- Ask SYSGEN dialogue questions and assemble source files 
for the Executive, device drivers, and, if requested, 
laboratory and industrial I/O subsystems. 


Phase II -- Task Build the Executive, device drivers, and all 
privileged tasks, define partitions for the system image, 
load device drivers, and install tasks. 


Phase III -- Optionally, Task Build unprivileged utilities. 


SYSGEN Phase I is divided into sections. The sections either define 
logical parts of an RSX-11M system or provide control information for 
SYSGEN. The following list shows the sections in SYSGEN Phase I along 
with a description of the function performed in each section, 
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SYSGEN 
Section Function 
Setup Defines for SYSGEN how to use saved answers 
(described below) and, in general, allows you to 
specify the way SYSGEN executes. . 
Target Defines for SYSGEN the hardware characteristics of 
your target system. 
Host Specifies whether you are running SYSGEN 
standalone (on the baseline system) or online (on 
a previously generated RSX-11M system) and also 
allows you to specify how you want SYSGEN to 
handle listings and maps. 
Executive Defines the Executive features you want to include 


in your RSX-11M target system. 


Terminal Driver Defines the type of terminal driver you want in 
your target system and the software features 
supported by the driver. 


Peripherals Describes control information for the peripherals 
included in your target system, such as Control 
Status Register (CSR) address and vector addresses 
for the peripherals. 


Assembly Provides you the opportunity to edit executive 
build files or laboratory and 1/0 build files 
before assembly of Executive and laboratory 
subsystem source files. 


SYSGEN provides the means to inhibit execution of MCR command lines 
during SYSGEN Phase I. This feature allows you to perform a SYSGEN 
without actually executing the commands that create, delete, assemble, 
or build task images. 


MCR command inhibition permits you to follow a_ logical path through 
SYSGEN without altering existing files. More importantly it provides 
an excellent opportunity for a user to become familiar with SYSGEN 
before actually performing a full or "live" SYSGEN. 


SYSGEN provides the means to save answers to questions asked during 
SYSGEN Phase I and Phase II. These answers are saved in a file called 
SYSSAVED.DAT. You can use this feature to select options and features 
for multiple target configurations or to vary the options and features 
generated for operating systems to be used on the same processor. 
When used in conjunction with MCR command inhibition, you can trace 
the logical flow of SYSGEN and then use the saved answers to generate 
an actual system. 


Three features permit you to execute SYSGEN Phase I without 
interruption. When used with saved answers, these features allow you 
to generate an RSX-11M operating system unattended. 
These three features are: 

e End-of-Section Breakpoints 


e End-of-Execution Breakpoints 


e End-of-Disk Breakpoints 


Fy 


) 
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1.3 FORMAT OF SYSGEN QUESTIONS 


SYSGEN questions provide a simple means for selecting the features you 
want in your. system. Based on your responses, SYSGEN generates 
various command files that control the assembly and task building of 
your system. 


The following question is an example that shows the form of most 
SYSGEN questions: 


* 2. Have you made a copy of the distribution kit? [Y/N]: 


Each SYSGEN question is preceded by an asterisk and a number. In 
SYSGEN Phase I, there aré seven sections; the questions in each 
section are numbered beginning with question number 1. The number is 
followed by the text of the question. The text of the question is 
followed by a prompt generated by the RSX-11M indirect command file 
processor, in this case [Y/N]:. 


When SYSGEN asks a question that requires a number as a response, the 
indirect command file processor generates a prompt that specifies the 
defaults and appropriate ranges or options, for example: 

* 35. Number of preallocated QIO packets [D R:0.-15. D:5]: 
The character D following the bracket indicates that the following 
numbers are decimal. R: specifies the range of numbers you can 
enter, in this case from 0 through 15. D: following the _ range 
specifies the default value SYSGEN uses when you enter only a carriage 
return, 
SYSGEN also asks questions that require ASCII strings as responses: 

* 50. Memory dump device (ddu:) [D: NL:][S]: 


In this case, the character D following the open bracket indicates the 


'default. [S]: specifies that an ASCII string response is required. 


Where there are exceptions to these general rules, SYSGEN displays 
prompts to explain how to answer questions. 


When you answer a question with an incorrect value, SYSGEN displays a 
message that describes the error and suggests a procedure to correct 
the problem. 


Error messages are listed alphabetically in Chapter 11. 


1.4 LOGICAL FLOW OF SYSGEN QUESTIONS 


As described above, questions in SYSGEN sections are numbered. 
However, SYSGEN never asks all questions; the questions asked are 
based on the response to previous questions. 


SYSGEN includes some features automatically when you select certain 
options and prints a message to inform you of their inclusion. More 
importantly, when you select an option that requires an option that 
you excluded, SYSGEN automatically includes the excluded option and 
informs you. 
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If you request DBMS support in Executive question 1, SYSGEN 
automatically includes Files-11 support (which would ordinarily be 
asked for in Exective question 2) and displays a message specifying 
that Files-11 support is being included: 


* 1. Will DBMS-11 be used [Y/N] :¥ 
Files-1l ACP support will be included 


If you had not selected DBMS, SYSGEN would have asked Executive 
question 2: 


* 1. Will DBMS-11 be used [Y/N]:N 
* 2, FILES-11 ACP [Y/N] :¥Y 


1.5 INVOKING THE SYSGEN COMMAND FILES 


As described above, system generation is controlled by command files 
known, collectively, as SYSGEN. There is one command file to control 
each phase of SYSGEN: 


SYSGEN.CMD Controls execution of SYSGEN Phase [I 
SYSGEN2.CMD Controls execution of SYSGEN Phase II 
SYSGEN3.CMD Controls execution of SYSGEN Phase III 


You invoke each of these as you would invoke any RSX-11M indirect 
command file: 


@filename 


‘where @ invokes the RSX-11M indirect command file processor and 
filename specifies the filename of the command file. You need not 
specify the filetype .CMD when you execute these files. 


When each indirect command file completes execution, it generates the 
prompt: 


@<EOF> 


This prompt indicates that a SYSGEN phase has completed execution. If 
you want to execute the next Phase, you must invoke it explicitly. 


As explained above, each of the three main SYSGEN command files must 
be explicitly invoked. However, SYSGEN.CMD (the control file for 
Phase I) invokes secondary control files, as shown in Figure 1-2. 


SYSGEN invokes other command files depending on the type of requests 
you make during the SYSGEN dialogue. These secondary command files 
all have the prefix SGN in their filenames rather than the SYS prefix 
used in the major command files. 


SGNEXEC and SGNPER are invoked when you specify that you want to 
answer executive and peripherals questions. SGNICIS or SGNIP is 
called when you specify that you have laboratory or I/O subsystem 
peripherals in your configuration. SGNTT is invoked when you are 
answering questions that define terminal driver characteristics. 
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@SYSGEN @SYSGEN2 @SYSGEN3 


SYSGEN.CMD SYSGEN2.CMD SYSGEN3.CMD 


i 


SGNEXEC.CMD 


SGNPER.CMD 


Me NIN 


SGNICIS.CMD 


Figure 1-2 


SGNIP.CMD SGNTT.CMD 


SYSGEN Command Files and How They Interrelate 


CHAPTER 2 


SETTING UP FOR SYSTEM GENERATION 


This chapter provides information on the following topics: 
e System generation environments 
@e Bootstrapping programs into processor memory 
@e RSX-11M distribution kit and baseline system 


e Backing up the distribution kit and bootstrapping the baseline 
system 


@ Startup Display Sequence 


2.1 SYSTEM GENERATION ENVIRONMENTS 


When you generate RSX-11M, an operating system controls the processor. 
In an online environment, you are generating RSX-11M under control of 
an operating system that has already been tailored to your 
hardware/software environment. When you must generate RSX-11M without 
such an operating system, you must use the RSX-11M baseline system. 


In general, if you are generating RSX-11M in an online environment, 
you need not go through many of the setup procedures described below. 


I£ you are generating a new system online, you should protect existing 
files and data; SYSGEN creates and deletes files and uses many UICs 
during its execution. You can protect existing files and data by 
isolating devices used by SYSGEN from system devices. For example, if 
your system device is normally DBO: and you have another unit 
available, run SYSGEN using DBl: (for example, ASN DB1:=SY:). 


If you are generating RSX-11M on the baseline system, you must follow 
the procedures described in this chapter. 


2.2 BOOTSTRAPPING PROGRAMS INTO PROCESSOR MEMORY 


Your PDP-11 processor must have a control program resident in its 
Memory before you can use the hardware resources. For the RSX-11M 
system generation, two systems are used to control system resources: 
the Disk Save and Compress (DSC) standalone system and the RSX-11M 
baseline system. DSC is discussed briefly later in this chapter and 
in detail in the RSX-11 Utilities Manual. The following sections 
discuss the RSX-11M baseline system. 
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These systems are loaded into memory using hardware bootstrap routines 
in PDP-11 Read-Only Memory (ROM). Ensure that you Know which of the 
bootstrap ROMs is in your processor. 


The keys on the console panel of your processor provide control 
functions you can use _ to bootstrap control programs into processor 
Memory. These console functions are controlled by switches which vary 
in appearance on different processors. Refer to the Processor 
Handbook for your processor for explanations of these functions. 


2.3 THE RSX-11M SYSTEM GENERATION DISTRIBUTION KIT 


RSX-11M distribution kits are the tape or disk media that contain the 
source, object, task, and command files you need to build your RSX-11M 
system. 


Regardless of whether your kit is a disk kit or a tape kit, RSX-11M 
system generation is always done using disks; if you receive a tape 
distribution kit, the tape(s) contains images for a particular type of 
disk kit. 


There are three types of kits: the dual RKOS kit, the RLO1l kit, and 
the big disk kit. The term "big disk kit" refers to the type of kit 
on which the entire distribution kit can be stored on a single disk 
volume. Big disk media can be one of the following: 


RK06/RK0O7 
RMO2/RMO3 
RP02/RP03 
RP04/RP05/RP06 


This section describes the types of RSX-11M distribution kits, the 
contents of each kit, and how to backup a kit. 


2.3.1 Types Of Distribution Kits 


RSX-11M is distributed on either disk or tape. Whether your kit is on 
disk or tape, create a backup copy on disk before you try to generate 
your system. 


The backup of the distribution kit provides a base against which you 
can update your system when you receive patches from DEC. Also, the 
backup provides you with a spare volume with which to retry SYSGEN in 
case you destroy important files or otherwise make your system 
unusable. 


2.3.1.1 Disk Distribution Kits - Disk kits are distributed on three 
types of disk media. The following list shows the disk type and the 
number of disks in the kits: 


Type of Number of 
Kit Disks 
RKO5 6 

RLO1 4 

Big Disk Kit (the RKO6 or RKO7 only) 1 


For big disk kits, only RKO6 or RKO7 disks are physically distributed, 
other big disk kits are furnished on magtape. 
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2.3.1.2 Tape Distribution Kits - RSX-11M is distributed on 6 types of 
tape kits. Each tape must be copied to disk using DSC before 
performing the SYSGEN; each tape contains DSC images for the 
appropriate type of disk. After you copy the tape to disk, the disk 
can be booted. All tapes are 9-track tapes. The following list shows 
the type of disk to which the tape must be copied, the number of tapes 
in the kit, the tape length, and the tape density before generating 
your system. 


Type of Number of Tape Tape 

Disk Tapes Length (feet) Density (bpi) 
RKO5 6 600 800 

RLO1/RLO 2 2 2400 800 
RKO6/RKO7 4 600 800 
RMO2/RMO3 1 2400 800 
RMO2/RMO03 1 2400 1600 

RP02/03 1 2400 800 
RP04/05/06 1 2400 800 
RPO04/05/06 1 2400 1600 


2.3.2 Contents of the RSX-11M Release Kit 


There may be several disks used during SYSGEN, depending on which kit 
you have. Each disk has a volume label that describes the contents of 
the disk. The following sections describe the contents of all three 
types of kits in terms of the contents of the volume in the RKOS kit. 


2.3.2.1 Volumes on the RKO5 Distribution Kit - The following list 
shows the volume name of each of the disks in the RKOS distribution 
kit, along with a brief description of the files on the volume. 


RSXM26 This disk contains the files that comprise the 
baseline system; this disk also contains various 
standalone systems used during system generation, 
for example, DSCS8, DSCS16, and PRESRV. 


EXCSRC This disk contains the source files for the 
RSX-l11M Executive; this disk also contains other 
files used by SYSGEN, including MAC and _  BIGMAC. 
Also included on this volume are standalone 
versions of DSC: DSCS8 and DSCS16. This volume 
contains the Backup and Restore utility (BRU) 
files and the files to produce Help text files. 
For information on the help text files, see 
Appendix H. 


DRVSRC This volume contains the source files for the 
drivers. This volume also contains the K~-series 
routines. 

MCRSRC This disk contains the source files for MCR, the 


shuffler, broadcast (BRO), console output task 
(COT), and the account file maintenance’ program 
(ACNT). 


PRVOBJ This disk contains the object files for RSX-llM 
privileged tasks, as well as .ODL and .OLB files. 


UTLOBJ This disk contains the object files for the 
RSX-11M utilities and nonprivileged tasks. 
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2.3.2.2 Volumes on the RLO1] Distribution Kit - The following list 
shows the volume name of each of the disks in the distribution kit, 
along with a brief description of the contents of the volume. 


RSXM26 This disk contains the files that comprise the 
baseline system 


MAPSRC Contains all the files required to build mapped ~ 


systems. The files in this volume correspond to 
the following volumes in the RKOS5S kit: 


EXCSRC 

DRVSRC 

PRVOBJ 
All task files are in UIC [1,54] for mapped 
systems. 

UNMSRC Contains all the files required to build unmapped 
systems. The files in this volume correspond to 
the same volumes as in MAPSRC, above. However, 
task files for unmapped systems reside in UIC 
(1,50). 

RLUTIL Contains files corresponding to the files in the 
following volumes on the RKOS kit: 

i UTLOBJ 
MCRSRC 


This disk also contains the Backup and Restore 
utility (BRU) files and the files to produce Help 
text files. For information on the help text 
files, see Appendix H. 


2.3.2.3 Volume on Big Disk Kits - The volume name of the disk for 
large disk kits is RSXM26. This volume contains all the source, 
object and other files required for system generation. 


2.3.3 Standalone DSC 


All distribution kits include standalone versions of the Disk Save and 
Compress (DSC) Utility. psc is used to create backup copies of the 
distribution kit. 


There are two versions of the standalone DSC utility, DSCS8 and 
pscsl16. pscss8 is used with 800 BPI (and 1600 BPI) tape devices and 
DSCS16 is used with 1600 BPI tape devices only. 


Disk kits include copies of both versions in UIC [1,51]. 


Included in each tape kit is a 600-foot, 9-track 800 BPI magnetic tape 
that contains a hardware bootable, standalone version of the Disk Save 
and Compress Utility (DSCS8). Use the DSC tape to copy tape kits to 
disk. 


) 


SETTING UP FOR SYSTEM GENERATION 


2.3.4 The RSX-11M Baseline System 


If you do not have an RSX-11M operating system for your host computer 
(your host computer is-the computer on which you are performing the 
system generation), you need an operating system to control the host's 
resources while you generate an RSX-11M operating system. DEC 
provides the RSX-11M baseline system for this purpose. 


During SYSGEN, many files are created, installed and removed, then 
deleted. Also, these files are contained in many UICs in order to 
separate one type of file from another. Among other reasons, the 
tasks on the baseline system are used to make these types of file 
manipulation functions possible. ; 


Execution of baseline system tasks is controlled by MCR (the RSX-11M 
Monitor Console Routine). 


The baseline system is an RSX-11M operating system that comprises only 
those software tools you need to generate a more complex system 
tailored to your specific configuration. 


2.4 BACKING UP YOUR DISTRIBUTION KIT AND BOOTSTRAPPING THE BASELINE SYSTEM 


When you receive the RSX-11M distribution kit, you should make a 
backup copy of the kit to ensure against accidents to the files and 
data on the kit and to provide a base for system updates. 


This section describes the procedures for backing up tape and disk 
distribution media. 


2.4.1 Backing Up Tape Distribution Media 


When you receive tape distribution media, use the hardware bootable 
DSC tape to copy the tape media to disk because the system generation 
program requires disk volumes for its processing. Once you copy the 
distribution media from tape, the tape is your backup copy of the kit. 


The procedure for copying from tape to disk and bootstrapping the 
baseline system is shown in Figure 2-1. 


Step 1 in Figure 2-1 is bootstrapping the standalone version of the 
Disk Save and Compress Utility (DSC) into processor memory. 
DSC provides the functions required to copy the RSX-11M 
distribution media. (For a complete description of DSC 
functions, refer to the RSX-ll Utilities Manual.) 


To bootstrap DSC, mount the DSC tape you receive with the 
distribution kit and the disk to which you are writing, and 
follow the hardware bootstrap procedures for your particular 
bootstrap ROM. The PDP-11 hardware bootstrap routine 
bootstraps the standalone version of DSC into processor memory 
and gives DSC control of the system. Dsc displays the 
following line when it is ready: 


RSX11S V2.2 BL26 DISK SAVE AND COMPRESS UTILITY V3.0 
DSCS8> 


You can then enter the DSC command lines to create disk copies 
of the distribution media. 
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Figure 2-1 Copying Tape Distribution Kits 


Step 2 in Figure 2-1 is copying the tape distribution media to disk 
using DSC. The following is the general format for entering 
DSC command lines to copy from tape to disk: 


DSC>outdevice:=indevice: 


where DSC> is the DSC prompt, outdevice: specifies the disk 
device to which DSC is copying data, and indevice: is the tape 
input device with the tape distribution media mounted. 


When the tape media is copied to disk, you can _ hardware 
bootstrap the baseline system and invoke SYSGEN. 


Step 3 in Figure 2-1 is to hardware bootstrap the RSX-11M baseline 
system into processor memory to control the system resources 
while SYSGEN is executing. 


To bootstrap the baseline system, mount the disk on which the 
baseline system resides, and follow the hardware bootstrap 
procedures for your particular bootstrap ROM. The PDP-11l 
hardware bootstrap routine bootstraps the baseline system into 
processor memory, giving control of the system to the baseline 
system. Section 2.5 describes the startup display sequence. 


Step 4 in Figure 2-1 is to verify the integrity of the disks you are 
using for system generation. Use the File Structure 
Verification Utility (VFY) to ensure the integrity of these 
disks. (The RSX-11 Utilities Manual provides details of all 
the functions performed by VFY.) 


Use the following command lines to ensure the integrity of a 
disk: 


>RUN SVFY 
VFY>/RC 
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/RC is the Read Check switch. This switch reads from the disk 
ensuring that each block on the disk that is allocated to a 
file can be read. If VFY reports that it cannot read a_ block, 
call your local DIGITAL Software Support Specialist for 
assistance. 


When you complete this procedure, you can invoke the SYSGEN procedure, 
as described in Chapter 3. 


2.4.2 


Backing Up Disk Distribution Media 


You can back up disk distribution media to either disk or tape backup 
volumes. Figure 2-2 outlines the procedure for creating a backup copy 
of disk distribution media. 
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Figure 2-2 Copying Disk Distribution Kits 
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in Figure 2-2 is to hardware bootstrap the RSX-11M baseline 
system into processor memory to control the system resources 
while SYSGEN is executing. 


To bootstrap the baseline system, mount the disk on which the 
baseline system resides, and follow the hardware bootstrap 
procedures for your particular bootstrap ROM. The PDP-11 
hardware bootstrap routine bootstraps the baseline system into 
processor memory, giving control of the system to the baseline 
system. Section 2.5 describes the startup display sequence. 


in Figure 2-2 is to install the MCR BOOT command (the software 
bootstrap routine) into memory. Using the BOOT command, you 
can bootstrap the standalone version of DSC into processor 
memory. You then use DSC to copy the kit. To install BOOT, 
enter the command line: 


>INSTALL $BOO 


The software bootstrap routine has the same effect as the 
hardware bootstrap routine, that is, it bootstraps DSC into 
processor memory and gives DSC control of the system. 


in Figure 2-2 is bootstrapping the standalone version of the 
Disk Save and Compress Utility (DSC) into processor memory. 
DSC provides the functions required to back up and restore data 
on the RSX-11M distribution media. (For a complete description 
of DSC functions, refer to the RSX-11 Utilities Manual.) 


To bootstrap DSC, using the software Boot task, enter the 
command Boo [1,51]pDscss, The software bootstrap routine 
bootstraps the standalone version of DSC into Processor memory 
and gives DSC control of the system. DSC displays’ the 
following line when it is ready: 


RSX115 V2.2 BL26 DISK SAVE AND COMPRESS UTILITY V3.0 
DSCS8> 


You can then enter the command lines to create copies of the 
distribution media. 


in Figure 2-2 is copying the disk distribution media to disk 

using DSC. The following is the general format for entering 

DSC command lines to copy from disk to disk: 
DSC>outdevice:=indevice: 

where DSC> is the DSC prompt, outdevice: specifies the device 

to which DSC is copying data, and indevice: is the input 

device with the distribution media mounted. 


When the media is copied, you can use the disk copy of the 
media to bootstrap the baseline system and invoke SYSGEN. 


in Figure 2-2 is to verify the integrity of the disks you are 


using for system generation. Use the File Structure 
Verification Utility (VFY) to ensure the integrity of these 
disks. (The RSX-11]1 Utilities Manual provides details of all 


the functions performed by VFY.) 


Use the following command line to ensure the integrity of a 
disk: 


>RUN SVFY 
VFY> /RC 
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“RC is the Read Check switch. This switch reads from the disk 
ensuring that each block on the disk that is allocated to a 
file can be read. If VFY reports that it cannot read a_ block, 
call your local DIGITAL Software’ Support Specialist for 
assistance, 


Step 6 in Figure 2-2 is to hardware bootstrap the RSX-11M baseline 
system into processor memory to control the system resources 
while SYSGEN is executing. 


To bootstrap the baseline system, mount the disk on which the 
baseline system resides, and follow the hardware bootstrap 
procedure for your particular bootstrap ROM. The PDP-11 
hardware bootstrap routine bootstraps the baseline system into 
processor memory, giving control of the system to the baseline 
system. Section 2.5 describes the startup display sequence. 


When you complete this procedure, you can invoke the SYSGEN procedure, 
as described in Chapter 3. 


2.5 START-UP DISPLAY SEQUENCE 


If the RSX-11M system being bootstrapped was built with a different 
device configuration than the current host, a series of display lines 
appears on the console in the form: 


Device ddnn: NOT IN CONFIGURATION* 
Where: 


dd=device NAME. 
nn=unit NUMBER. 


(Devices not in the configuration are declared OFFLINE and the display 
OFFLINE is appended to these devices as part of the output of the MCR 
Devices command). 


Then the system displays: 


RSX-11M <vers—num><base-level><mem-siz> [mapped] 
>RED DDNN:=SY0: 

>RED ddnn:=LBO: 

>MOU ddnn:volname 

>@[1,2] STARTUP 


Where: 
<vers=-num> ~ The release version number (for example, 
release 3.2 of RSX-11M is V3.2). 
<base-level> - The software development group at DIGITAL 


periodically brings together new versions 
of the software under development. 
Internal groups may use this software to 
ensure correct operation and to build new 
software. These development milestones 


are called base levels. For example, 
release 3.2 of RSX-11M is base level 
BL26. 
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<mem-siz> - The memory size (in the form of nnnk) of 
the machine on which the system was 
bootstrapped. 

(mapped] - Mapped is displayed for systems built to 
use the Memory Management Unit. 

ddnn: - Device name and unit number of the _ boot 
device. 

volname - The name of the volume that contains’ the 


booted system. 


[1,2] STARTUP 


The file specifier for the indirect 
command file, which is invoked 
automatically at bootstrap time and which 
contains user commands for initializing 
the bootstrapped system. 


The system is now ready for operation. The RED and MOU displays are 
internally generated Redirect and Mount commands. The Redirect 
command establishes the load device as the system and library devices 
SY: and LB:, and the Mount command mounts the load device as a 
Files-11 volume. 


int 
) 
kup 
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GETTING STARTED 


This chapter describes the pre-processing steps which prepare the host 
system for the system generation procedure. 


Each type of distribution kit is described in a separate section. 
Read the section that pertains to your kit as follows: 


e Big disk distribution kits, Section 3.1 
@e Dual RKOS5 distribution kits, Section 3.2 
@ RLO1 distribution kits, Section 3.3 


To perform a SYSGEN, you must be privileged. Privileged status 
insures that the command files can access as well as create and delete 
files in various UFDs. 


To perform a PREPGEN, privileged status is not required; a PREPGEN 
does not create or delete files (if requested, a PREPGEN creates the 
file SYSSAVED.DAT). Also, a PREPGEN uses the UFD that corresponds” to 
the default UIC of the terminal to find command files and create 
SYSSAVED.DAT. 


NOTE 
If you wish to direct listings or maps 
to a device other than SY:, LB:, or TI:, 
you should load the driver and then 


mount the device before you begin. the 
system generation process, 


3.1 BIG DISK DISTRIBUTION KITS 


If you have a previously generated RSX-11M version 3.2 system, read 
Section 3.1.1. 


If you do not have a running RSX-11M version 3.2 system available, 
read Section 3.1.2. 
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3.1.1 Online SYSGENs and PREPGENS 


The following lists the pre-processing steps to perform an online 
-SYSGEN or PREPGEN: 


1. Mount the baseline system disk. For example: 
>MOU DB2:RSXM26 


2. Assign the baseline system disk to the pseudo device SY:. 
For example: 


>ASN DB2:=SY: 


3. The system generation command files require an indirect 
command file processor with extended symbol table space. For 
mapped systems, this is a 12K-word version (BIGIND). For 
unmapped systems, this is a 14K-word version (BIGIND). I€£ 
the running system contains the 8K-word indirect (without 
symbol table space extensions), remove the task AT. and 
install BIGIND specifying a priority of 10(10). For example: 


>REM ...AT. 
>INS SBIGIND/PRI=10. 


4. If performing a SYSGEN, set the UIC to [200,200]. For 
example: 


>SET /UIC=[200,200] 
This is not required to perform a PREPGEN. 
‘5. Initiate SYSGEN Phase I. For example: 
>@SYSGEN 


6. For a summary of the Phase I questions, read Chapter 4. For 
a detailed description of Phase I questions, read Chapter 5. 


3.1.2 Standalone SYSGENS and PREPGENS 


The following lists the pre-processing steps to perform a SYSGEN or 
PREPGEN using the baseline system, 


1. Hardware bootstrap the system using the device that contains 
the baseline system disk (RSXM26) as the boot device. This 
will bring up the unmapped baseline system. If the host 
system includes the memory management unit and you are 
generating a mapped system, software boot the mapped baseline 
system. For example: 


>INS $BOO 
>BOO [1,54] RSX11M 


2. The system generation command files require an indirect 
command file processor with extended symbol table space. For 
mapped systems, this is a 12K-word version (BIGIND). For 
unmapped systems, this is a 14K-word version (BIGIND). The 
baseline system contains the 8K-word version, which lacks 
sufficient symbol table space. Remove the task AT. and 
install BIGIND specifying a priority of 10(10). For example: 


>REM ...AT. 
>INS $BIGIND/PRI=10. 
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3. Initiate SYSGEN Phase I. For example: 
>@SYSGEN 


4. For a summary of the Phase I questions, read Chapter 4. For 
a detailed description of Phase I questions, read Chapter 5. 


3.2 DUAL RKOS DISTRIBUTION KITS 


The dual RKOS distribution kit requires two RKO5 drives. When SYSGEN 
completes processing of the Executive source disk (EXCSRC), you must 
replace the disk with the driver source disk (DRVSRC) so that SYSGEN 
can access the driver source files. This is known as an end-of-disk 
breakpoint (EOD). Note that if your host configuration includes more 
than two RKO5 drives, you can override these breakpoints. See Chapter 
5 for details. 


3.2.1 Online SYSGENS and PREPGENS 


The following lists the pre-processing steps to perform an online 
SYSGEN or PREPGEN: 


1. Mount the baseline system disk. For example: 
>MOU DK:RSXM26 


2. Assign the baseline system disk to the pseudo device SY:. 
For example: 


>ASN DK:=SY: 


3. The system generation command files require an indirect 
command file processor with extended symbol table space. For 
mapped systems, this is a 12K-word version (BIGIND). For 
unmapped systems, this is a 14K-word version (BIGIND). If 
the running system contains the 8K-word version (without 
symbol table space extensions), remove the task AT. and 
install BIGIND specifying a priority of 10(10). For example: 


>REM ...AT. 
>INS SBIGIND/PRI=10. 


4. If performing a SYSGEN, set the UIC to [200,200]. For 
example: 


>SET /UIC=[200,200] 
This is not required to perform a PREPGEN. 


5. If performing a PREPGEN, mount the Executive source disk and 
assign this device to the pseudo device LB:. For example: 


>MOU DK1:EXCSRC 
>ASN DK1:=LB: 


This is not required to perform a SYSGEN; a SYSGEN 
automatically issues Mount and Assign commands for the device 
that contains the Executive source files, 


6. 


7. 
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Initiate SYSGEN Phase I. For example: 
>@SYSGEN 


For a summary of the Phase I questions, read Chapter 4. For 
a detailed description of Phase I questions, read Chapter 5. 


3.2.2 Standalone SYSGENs and PREPGENS 


The following lists the pre-processing steps to perform a SYSGEN or 
PREPGEN using the baseline system: 


3.3 


l. 


Hardware bootstrap the system using the device that contains 
the baseline system disk (RSXM26) as the boot device. This 
will bring up the unmapped baseline system. If the host 
system includes the memory management unit and you are 
generating a mapped system, software boot the mapped baseline 
system. For example: 


>INS $BOO 
>BOO [1,54] RSX11M 


The system generation command files require an indirect 
command file processor with extended symbol table space. For 
mapped systems, this is a 12K-word version (BIGIND). For 
unmapped systems, this is a 14K-word version (BIGIND). The 
baseline system contains the 8K-word version, which lacks 
sufficient symbol table space. Remove the task AT. and 
install BIGIND specifying a priority of 10(10). For example: 


>REM ...AT. 
>INS SBIGIND/PRI=10. 


If performing a PREPGEN, mount the Executive source disk and 
assign this device to the pseudo device LB:. For example: 


>MOU DK1:EXCSRC 
>ASN DK1:=LB: 


This is not required to perform a SYSGEN; a SYSGEN 
automatically issues Mount and Assign commands for the device 
that contains the Executive source files. 
Initiate SYSGEN Phase I. For example: 

>@SYSGEN 


For a summary of the Phase I questions, read Chapter 4. For 
a detailed description of Phase I questions, read Chapter 5. 


RLO1 DISTRIBUTION KITS 


The RLO1L distribution kit requires two RLO1 drives to perform a SYSGEN 


or 


PREPGEN. However, you can perform a SYSGEN or PREPGEN using a 


single RLO1 provided that you have a secondary storage device. The 


secondary 


storage device can be a magtape unit or a disk drive of a 


different type. 
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To generate a system using two RLO1l drives, you simply load the 
baseline system disk (RSXM26) and either the mapped source disk 
(MAPSRC) to generate a mapped system or the unmapped source disk 
(UNMSRC) to generate an unmapped system. 


To generate a system using a single RLO1l drive, you must copy the 
contents of [11,10] from the mapped or unmapped source disk (MAPSRC 
for mapped target systems, UNMSRC for unmapped target systems) to 
secondary storage. Later, during SYSGEN Phase II, you will copy these 
files from secondary storage onto the baseline disk under [1,24]. 
Note that both the mapped and unmapped source disks contain a bootable 
copy of RSX-11M. Thus, if you are running standalone, you must boot 
the proper disk (MAPSRC for mapped target systems, UNMSRC for unmapped 
target systems), copy [11,10] to secondary storage, and then reboot 
using the baseline system disk. 


If your secondary storage device is a disk drive of a different type 
and the driver is loadable, you can specify this drive as the device 
that contains the Executive sources (obviously, you must first copy 
the mapped or unmapped sources to this drive). 


3.3.1 Online SYSGENsS and PREPGENS 


The following lists the pre-processing steps to perform an online 
SYSGEN or PREPGEN: 


1. Mount the baseline system disk. For example: 
>MOU DL:RSXM26 


If you are using a single RLO1 drive, you must first copy the 
contents of [11,10] from the mapped or unmapped source disk 
to secondary storage. 


To generate a mapped system, mount the mapped source disk 
(MAPSRC) and copy the contents of [11,10] to secondary 
storage. For example: 


>MOU DL:MAPSRC 
>FLX MM:/ZE 
>FLX MM:/DO=DL: [11,10]*.*/RS 


To generate an unmapped system, mount the unmapped source 
disk (UNMSRC) and copy the contents of [11,10] to secondary 
storage. For example: 


>MOU DL:UNMSRC 
>FLX MM:/ZE 
>FLX MM:DO=DL:[11,10]*.*/RS 


When the copy completes, dismount and unload the mapped or 
unmapped source disk and mount the baseline system disk. For 
example: 


>MOU DL:RSXM26 


2. Assign the baseline system disk to the pseudo device SY:. 
For example: 


>ASN DL:=SY: 
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The system generation command files require an indirect 
command file processor with extended symbol table space. For 
mapped systems, this is a 12K-word version (BIGIND). For 
unmapped systems, this is a 14K-word version (BIGIND). If 
the running system contains the 8K-word indirect (without 
symbol table space extensions), remove the task AT. and 
install BIGIND specifying a priority of 10(10). For example: 


>REM ...-AT. 
>INS $BIGIND/PRI=10. 


If performing a SYSGEN, set the UIC to [200,200] For example: 
>SET /UIC=[200,200] 

This is not required to perform a PREPGEN. 

Initiate SYSGEN Phase I. For example: 
>@SYSGEN 


For a summary of the Phase I questions, read Chapter 4. For 
a detailed description of Phase I questions, read Chapter 5. 


3.3.2 Standalone SYSGENs and PREPGENs 


The following lists the pre-processing steps to perform a SYSGEN or 
PREPGEN using the baseline system: 


l. 


Hardware bootstrap the system using the device that contains 
the baseline system disk (RSXM26) as the boot device. This 
will bring up the unmapped baseline system. If the host 
system includes the memory management unit and you are 
generating a mapped system, software boot the mapped baseline 
system. For example: 


>INS $BOO 
>BOO [1,54]RSX11M 


If you are using a single RLO1 drive, you must first hardware 
bootstrap the mapped or unmapped source disk. Then copy the 
contents of [11,10] to secondary storage. 


To generate a mapped system, hardware bootstrap the system 
using the device that contains the mapped source disk 
(MAPSRC) as the boot device. Then copy the contents of 
[11,10] to secondary storage. For example: 


>FLX MM:/ZE 
>FLX MM:/DO=DL: [11,10]*.*/RS 


To generate an unmapped system, hardware bootstrap the system 
using the device that contains the unmapped source disk 
(UNMSRC) as the boot device. Then copy the contents of 
{11,10] to secondary storage. For example: 


>FLX MM:/ZE 
>FLX MM:/DO=DL: [11,10]*.*/RS 
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When the copy operation completes, halt the system and remove 
the mapped or unmapped source disk from the drive. Then, 
reboot using the baseline system disk. 


The system generation command files require an indirect 
command file processor with extended symbol table space. For 
mapped systems, this is a 12K-word version (BIGIND). For 
unmapped systems, this is a 14K-word version (BIGIND). The 
baseline system contains the 8K-word version, which lacks 
sufficient symbol table space. Remove the task AT. and 
install BIGIND specifying a priority of 10(10). For example: 


>REM ...AT. 
>INS S$BIGIND/PRI=10. 


Initiate SYSGEN Phase I. For example: 
>@SYSGEN 


For a summary of the Phase I questions, read Chapter 4. For 
a detailed description of Phase I questions, read Chapter 5. 


CHAPTER 4 


SUMMARY OF SYSGEN PHASE I QUESTIONS 


This chapter provides summary information for SYSGEN Phase I. The 
chapter is meant to help familiarize you with the SYSGEN questions and 
as reference for when you become familiar with SYSGEN. 


4.1 SUMMARY OF SYSGEN PHASE I SETUP QUESTIONS 


The following list comprises the possible setup questions for SYSGEN 
Phase I. 


Not all of the questions are pertinent; the order of the questions 
depend upon the distribution kit you are using as_ well as the 
responses to the questions. For complete details and the implications 
of your responses, see Chapter 5. 


1. Inhibit MCR command lines (Type <ESC> for explanation) 


An affirmative response permits you to follow the logical flow of 
a specific SYSGEN, without actually executing commands that 
assemble, build, or delete files. The manual refers to this as a 
PREPGEN. 


A negative response indicates that you wish to perform a "live" 
SYSGEN. 


2. Have you made a copy of the distribution kit 


If you are performing a SYSGEN, this question insures that you 
have copied the distribution kit. Following a negative reply, 
SYSGEN exits to allow you to do so. 


3. Use saved or canned answer files for input responses 


This question permits you to use a saved answer file as responses 
to SYSGEN questions. 


4. Undefined answer wakeup 


If you are using a saved answer file, an affirmative response to 
this question instructs SYSGEN to precede necessary questions 
(either a question you did not answer or a question for which a 
saved response does not exist) with a CTRL/G (bell). Thus, 
SYSGEN alerts you when a response is required. 


5. Use saved host configuration 
If you are using a saved answer file, an affirmative response 
indicates that SYSGEN can use your previous host responses. For 
example, you are performing SYSGEN on the same host 
configuration. 
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Use saved peripheral configuration 


If you are using a saved answer file, an affirmative response 
indicates that you do not wish to change the peripheral 
configuration. 


Skip end of section (EOS) breakpoints 


If you are using saved answer files, an affirmative response 
permits SYSGEN to continue after each section of Phase I. 


Skip end of execution (EOX) breakpoints 


If you are using a saved answer file, an affirmative response 
instructs SYSGEN to continue after assembly or task build 
operations complete. For example, you are certain that all 
device drivers will assemble correctly. 


Skip end of disk (EOD) breakpoints 


Dual RKO5 kits only. An affirmative response indicates that you 
do not have to change RKO5 disks. For example, you have more 
than two RKO5 drives available (one for the baseline system, one 
for the Executive source files, and one for the device driver 
source files). 


Save responses (i.e.: create SYSSAVED.DAT) 


An affirmative response instructs SYSGEN to create the file 
SYSSAVED.DAT, which can later be used as input to SYSGEN. See 
Chapter 5, 


UIC for SYSSAVED files if not [current UIC] 


If you are using a saved answer file, SYSGEN assumes that’ the 
file is in the UFD corresponding to the current UIC. Enter a UIC 
to override this default. Also, if you are creating the file 
SYSSAVED.DAT (a Yes response to question 10), SYSGEN will create 
the file in the UFD corresponding to the current UIC. Again, 
enter a UIC to override this default. 


UIC for SYSGEN command files if not [current UIC] 


SYSGEN assumes the command files are in [200,200] for SYSGENs. 
If you have moved them, enter a UIC. 


If you are performing a PREPGEN (a Yes reply to question 1), 
SYSGEN assumes the command files are in the UFD corresponding to 
the current UIC. If they are not, enter a UIC. 


Clean up files from previous GENs 

If you are performing a SYSGEN, disk space becomes critical. An 
affirmative response instructs SYSGEN to delete old and 
unnecessary files created during previous SYSGENS (for example, 
RSXBLD.CMD and RSXASM.CMD). 


Device, when ready, for Executive sources (ddu:)[D: SY:] 


i 
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NOTE 
If you are using the RLO] or the dual RKO5 distribution 
kit, there is no default response to this question; you 


Must enter the device that contains the Executive source 
files. 


For big disk kits, SYSGEN assumes that the Executive source files 
are on SY:. Enter a device specification if not. 
15. Driver source files device (ddu:) 


Dual RKO5 kits only. Enter the device that contains the device 
driver source files. 


2ASN SY:=LB:; 
>PIP /FR 


Following the free block display, SYSGEN changes the UIC to [11,10]. 


>SET /UIC=[11,10] 


4.2 SUMMARY OF TARGET AND HOST QUESTIONS 

The SYSGEN Phase I target and host questions ask you to define the 
target and host configurations. Target questions define hardware 
features in your configuration as well as the attached peripheral 
devices. Host questions determine, primarily, how you want to handle 
listings. 


The following list comprises the possible target and host questions 
for SYSGEN Phase I. 


Target 

1. Processor (e.g.: 11/34, LSI-11) 

Enter the target processor type. 
2. Does processor have a switch register 

Enter Yes if the target processor has a switch register. 
3. Generating RSX~115S 

Enter Yes if you wish to generate an RSX-11S system. 
4. Memory size (in K-word blocks) 


Enter the number of K-word blocks of memory for the target 
processor. Note that memory blocks must be a multiple of 4K. 


5. Mapped 


Enter Yes if you are generating a mapped system. Note that a 
mapped system requires a minimum of 24K-words of memory. 


6. Any K-series laboratory devices 


Enter Yes if the target configuration includes the K-series 
laboratory peripheral options. 
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Extended arithmetic element (KE11-A/B EAE) present 


Enter Yes if the target processor contains the PDP-11 EAE option. 


Floating point processor (FP-11) present 


Enter Yes if the target processor includes the floating point 
option, 


Floating instruction set (FIS) present 


Enter Yes if the target configuraton includes the floating 
instruction set processor, 


If using KW11-P as system clock: number of intrps./sec. 

If you are using the KW11-P programmable clock as the system 
clock, enter the number of interrupts per second. Note that the 
number of interrupts must evenly divide into 10,000. 

Line frequency: A~60Hz B-50Hz [D: "A"] 

Enter the line frequency. The default is 60Hz. 

KW11-Y Watchdog timer support 

Enter Yes if the target configuration includes the KW11-Y. 

Memory parity support 

Enter Yes if the target configuration contains parity memory. 


Cache memory 


In conjunction with memory parity support, cache memory speeds 
main memory operations. Enter Yes if your system includes it. 


Highest interrupt vector (If 0 will be computed) 

SYSGEN automatically computes the highest interrupt vector 
address. Enter a value greater than 400 if you require vector 
space for devices not specified during SYSGEN. 

Devices 


Enter the device mnemonic for all pseudo and peripheral devices 
to be included in the target configuration. 


Enter an asterisk (*) for a list of devices and mnemonics. 


For a device-type with multiple controllers, enter the 
device-type, an equal sign (=), and the number of controllers. 
For example, DK=2. Note that SYSGEN assumes one controller for 
the device-type if you omit the equal sign. 


SYSGEN prompts for a device mnemonic until you terminate the 
entry (or the question) with a period (.). 
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Host 
1. Are you running SYSGEN standalone (on the baseline system) 


Enter Yes if you are not running SYSGEN on a previously generated 
RSX-11M system. 


2. Is a line printer available 


Enter Yes if the host configuration includes a line printer. 
(The printer can be used for listing and map files.) 


3. Spool assembly listing and Executive and driver maps 


Enter Yes if you want these files spooled to the line printer. 
Enter No if you want to save the files, but not print them. 


4. Does the listing/map device have at least 120 columns 


Enter Yes if the printer has at least 120 columns. Otherwise, 
SYSGEN forces narrow listings. 


5. Assembly listings device (ddu:) [D: NL:] 


Usually, assembly listing files are not required. If you desire 
or require these files, enter a device specification. 


6. Map device for Executive and device drivers (ddu:) [D: SY:] 


For unmapped systems, maps are _ required. Enter a device 
specification if you do not want to uSe SY:. 


For mapped systems, the maps may prove helpful. Enter a device 
specification if you do not want to use SY:. 


Be advised that you should not enter NL:. 
EOS * Do you want to: <CR>-continue R~-repeat section E~exit P-pause 


A response of carriage return begins Executive option generation. 


4.3 SUMMARY OF EXECUTIVE QUESTIONS 


The following list comprises the possible Executive questions for 
SYSGEN Phase I. Not all of the questions appear during an actual run 
of SYSGEN. For example, some options require Executive support of 
other options; SYSGEN automatically includes Executive support if it 
is required in your system. For complete details on the Executive 
options and their implications, refer to Chapter 5. 


Unless otherwise noted, a Yes response includes Executive support for 
the option. 


1. Will DBMS~-11 he used 


Enter Yes to include Data Base Management System support. For 
details on DBMS, see the DBMS-11 documentation. 
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FILES-11 ACP 


Enter Yes to include the services described in the IAS/RSX-11 I/0 
Operations Reference Manual. 


RMS record locking and placement control 


Enter Yes to include support for the Record Management System. 
See the RMS documentation for details. 


Non-resident tasks (task loader) 
Enter Yes to include support for the task loader. The task 
loader: reads a task into memory; performs a checkpoint write 
of a task image from memory to disk; or performs a _ checkpoint 
read of a task image from disk into memory. 

Loadable task loader 
Enter Yes to include support for the loadable task loader. The 
loadable task loader reduces the amount of address space required 
for the Executive. 

Memory managment (PLAS) directives 
Enter Yes to include support for the memory management 
directives. These directives allow tasks greater span of 
physical memory. 


Send/Receive by reference directives 


Enter Yes to include support for the send/receive by reference 
directives. 


Get mapping context directive 
Enter Yes to include support for this directive. 

Address checking 
Enter Yes to include Executive support for address’ checking. 
This option provides boundary and alignment checks on addresses 
passed by users in Fxecutive directives. 
I/O rundown 
Enter Yes to include Executive support for I/O rundown. This 
option helps insure system integrity by cleaning up outstanding 
I/O before allowing a task (for example Dismount) to exit. 


Multi-user protection 


Enter Yes to generate a multiuser protection system. This option 
protects against destructive interference between users. 


ANSI magtape : 


Enter Yes to include Executive support for ANSI magnetic tapes. 
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On-line formatting (FMT) or on-line user-mode diagnostics 


Enter Yes to include support for the volume format (hardware) 
utility (FMT) and User-Mode Diagnostics (UMDs). 


Loadable device drivers 


Enter Yes to include Executive support for loadable device 
drivers. 


Should the default for all applicable drivers be loadable 


Enter Yes to default drivers that can be loaded to be loadable, 
rather than resident. 


AST and cancel selective MARKTIMES 

Enter Yes to permit processing of Asynchronous System Traps 
(ASTs) and provide the ability to cancel selective marktime 
requests. 

Task termination and device not ready messages (TKTN) 

Enter Yes to include this option. 

Power fail recovery 

Enter Yes to include this option. 


Install, request, and remove or exit 


Enter Yes to include this feature of the Run command. This 
feature helps optimize use of Executive dynamic memory resources. 


Large (20K) Executive 


Enter Yes to generate an Executive larger than 16K and_ thus 
increase pool space. 


Logical device assignment 
Enter Yes to include support for the MCR Assign command, 
Logging of device errors and timeouts 


Enter Yes to permit the error logging subsystem to intercept 
device errors and write status information in a file. 


Logging of undefined interrupts 


Enter Yes to permit the error logging subsystem to record traps 
to undefined interrupt vectors ina file. 


Logging of memory parity errors 


Enter Yes to permit the error logging susbsystem to record cache 
and main memory parity error information in a file. 


Do you intend to include a user-written driver 
Enter Yes if you have written your own device driver(s). SYSGEN 


will permit you to include your drivers when it assembles the 
Executive. 
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Include routine $GTWRD 

Enter Yes to include support for the SGTWRD Executive routine. 
This routine obtains, or fetches, a word from a user-defined 
buffer. 

Include routine $PTWRD 


Enter Yes to include the S$PTWRD Executive routine. This routine 
sends a word to a user-defined buffer. 


Disk writecheck 


Enter Yes to include disk writecheck support. When enabled, this 
option increases data reliability, but decreases disk throughput. 


Executive debugging tool (XDT) 


Enter Yes to include the Executive Debugging Tool (XDT). XDT is 
useful in debugging privileged tasks and user-written drivers. 


Rotating pattern in data lights 

Enter Yes to include this option. The processor data lights 
rotate in a pronounced circular pattern when the processor is 
idle. 

Industrial network or DECnet 

Enter Yes to include industrial network or DECnet support. 

Queue manager and queued print spooler 

Enter Yes to include complete spooling support. 


Group global event flags 


Enter Yes to include Executive support for group global event 
flags and MCR support for the Flags command. 


Enter code for directives 


Enter an asterisk (*) for a list of the Executive directives and 
then enter the letter(s) that correspond to the desired 
directives. A percent sign (%) selects all the directives. 
Terminate the question with a period (.). 


Number of pre-allocated QIO packets 


Enter a numeric response in the range 0 to 15 to specify the 
number of QIO packets to allocate from pool. 


A response of 0 excludes the option. 

Note that the default response is 5. Therefore, if you simply 
enter carriage return, you select the option and allocate 5 I/0 
packets from pool. 

Size of data transfer vector in words 

Enter a numeric response in the range 5 to 33 to specify the 


number of MOV instructions to include in the data transfer 
vector. 
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Round-robin scheduling interval in ticks 


Enter a numeric response in the range 0 to 1000 to specify the 
round-robin scheduling interval. 


A response of 0 excludes the option. 

Note that the default response is 5. Therefore, if you simply 
enter carriage return, you select the option and specify 5 clock 
ticks as the scheduling interval. 


Highest priority class for consideration 


Enter a numeric response in the range 1 to 249 to specify the 
highest, eligible priority class for round-robin scheduling. 


Lowest priority class for consideration 

Enter a numeric response in the range 1 to the response entered 
in question 38 to specify the lowest, eligible priority class for 
round-robin scheduling. 


Executive level disk swapping interval 


Enter a numeric response in the range 0 to 5000 to specify the 
disk swapping interval. 


A response of 0 excludes the option. 

Note that the default is a value equal to the round-robin 
scheduling interval multiplied by 6. Therefore, if you simply 
enter carriage return, you select the option and specify 6 times 
the round-robin interval as the swapping interval. 

If you did not select round-robin scheduling (response of 0 to 
question 37), the default is 30. Therefore, if you simply enter 
carriage return, you select Executive level disk swapping and 
specify 30 as the swapping interval. 

Swapping priority 


Enter a numeric response in the range 1 to 20 to specify the 
range over which lower priority tasks may checkpoint higher ones. 


The default response is 5, which is highly recommended. 
Size of dynamic storage region (POOL) in words 


Enter a numeric response that is in the range 256 to 16384 and a 
multiple of two. 


Seconds between printer not ready messages 


Enter a numeric response in the range 0 to 255 to specify the 
number of seconds between line printer not ready messages. 


A response of 0 suppresses the messages. 


If you make a non-zero entry, the value must be greater than 15. 
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Note that the default is 30 seconds. If you simply enter 
carriage return, the message appears every 30 seconds when the 
line printer is not ready (out of paper, or offline, for 
example). 

Seconds between card reader not ready messages 

Enter a numeric response in the range 0 to 255. 

A response of 0 suppresses the messages. 

If you make a non-zero entry, the value must be greater than 15. 
Note that the. default is 30 seconds. If you simply enter 
carriage return, the message appears twice a minute when the card 
reader is not ready. 

System crash register and stack dump device CSR 


Enter 0 to exclude this option. Otherwise, enter a numeric 
response in the range 160000 to 177700. 


Note that the default response selects the option and dumps_ the 
Executive stack and registers on the console terminal following a 
system crash. 

Checkpointing: A-Yes B-With system ckpnt. file 

Enter A to include checkpointing, B to include checkpointing to 
system checkpoint files (and support the Allocate Checkpoint 
Space (ACS) command), or carriage return to exclude checkpointing 
altogether. 

System controlled partitions: A-Yes B-With auto compaction (SHF) 
Enter A to include system controlled partitions, B_ to include 
system controlled partitions with the shuffler (SHF), or carriage 
return to exclude support for system controlled partitions. 

Dump analysis: A-PANIC B-Crash (CDA) 

Enter A to include the panic dump routine (PANIC), B to include 
the crash dump analyzer (CDA), or carriage return to exclude 
support for memory dumps following a system crash. 

It is recommended that you select either PANIC or CDA. 

Output notification device CSR 


Enter a numeric value in the range 160000 to 177700 to _ specify 
the CSR address for the CDA routine to output crash notification. 


Memory dump device (ddu:) 


Enter the device mnemonic and unit number for the device you wish 
the CDA routine to direct memory dumps. 


CSR address of dump device 


Enter a numeric response in the range 160000 to 177700 to specify 
the CSR address of the console terminal. 


The default response is the default CSR address of the memory 
dump device. 
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52. CSR address of PANIC dump device 


Enter a numeric response in the range 160000 to 177700 to specify 
the CSR address of the device for the PANIC routine to dump the 
Executive stack and registers. 


The default response causes PANIC to dump the stack and registers 
to the console terminal. 


4.4 SUMMARY OF TERMINAL DRIVER QUESTIONS 


The following list comprises the possible terminal driver questions 
for SYSGEN Phase I. 


1. Terminal driver desired (A/B/C/D, * prints table) 


Enter an asterisk to print a list of the available terminal 
drivers, Then enter A to select the half duplex terminal driver 
that you tailor to your system requirements, B to select the 
tailored (user-oriented) half duplex terminal driver, C to select 
the full duplex terminal driver, or D to select the baseline half 
duplex terminal driver. Chapter 5 lists the options included in 
the user-oriented and full duplex terminal drivers. 


2. Unsolicited input timeout value in seconds 
Enter a numeric response in the range 0 to 2540 to specify the 
interval, in seconds, that the full duplex terminal driver waits 
before discarding unsolicited terminal input. 


A response of 0 inhibits the full duplex terminal driver 
unsolicited input timeout feature. 


Note that the default response is 120 seconds. Therefore, if you 
simply enter carriage return, you select this feature and specify 
that the driver timeout after two minutes. 

3. Pass form feeds directly to the terminal 


Enter Yes to suppress conversion of a form feed into 8 line 
feeds, 


4. Automatic carriage return/line feed 


Enter Yes to generate a carriage return and line feed whenever 
the terminal buffer is filled, either on output or echo. 


5. Task checkpointable during terminal input 


Enter Yes to allow tasks to displace checkpointable tasks from 
memory during terminal input. 


6. Unsolicited input character AST 


Enter Yes and a task attaching to a terminal can specify an AST 
entry point on receiving unsolicited input characters. 
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7. Write with CTRL/O cancellation 
Enter Yes to permit write requests with CTRL/O cancellation to 
print to the terminal, regardless of whether or not the terminal 
has suppressed output by CTRL/O. 

8. Breakthrough write 


Enter Yes and breakthrough write requests can print to _ the 
terminal, regardless of terminal I/O activity. 


9. CTRL/R (retype) 


Enter Yes and CTRL/R sends a carriage return/line feed followed 
by the input buffer to the terminal. 


10. Escape sequence handling 


Enter Yes to recognize and treat escape sequences as line 
terminators. 


ll. Get multiple characteristics 


Enter Yes to allow tasks to determine characteristics of 
individual terminals. 


12. Set multiple characteristics 
Enter Yes to allow tasks to set or reset characteristics of their 
TI: terminal. Privileged tasks can set characteristics of any 
terminal. 


13. Get terminal driver options 


Enter Yes to allow tasks to determine which terminal driver 
options were selected during SYSGEN. 


14. Hold screen mode 


Enter Yes to allow terminals (with special hardware) to break 
output into pages that fit on the screen. 


15. Transparent read/write 
Enter Yes to provide support for I/O functions (IO.RAL and 
IO.WAL) that bypass character filtering and permit output of up 
to 32K bytes. 

16. Settable case conversion for input 


Enter Yes to permit the driver to selectively, on a per-terminal 
basis, convert lower case input to upper case. 


17. Read after prompt 
Enter Yes to permit a read after prompt request to act like a 


write to the terminal followed by a read. This reduces overhead 
and eliminates context switching. 
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18. Read with no echo 


Enter Yes to permit issuing read functions (IO.RLB, IO.RVB, and 
IO.RPR) specifying that terminal input not be echoed. 


19. Read with special terminator 
Enter Yes to permit any character less than 40 octal or greater 
than 174 octal to terminate a read with special terminator 
request. 

20. CRT rubout support 
Enter Yes to select the backspace-deletion function. 

21. Terminal-host synchronization 
Enter Yes to allow CTRL/S and CTRL/Q from a terminal. 


22. User terminal input buffering 


Enter Yes to place input characters directly into a 
non-checkpointable task buffer as received. 


23. Variable length terminal input buffering 


Enter Yes to allocate buffers large enough to contain read 
requests, 


24. LA30P support 


Enter Yes to include support for an LA30P; this prevents 
discarding the second of two rapidly typed characters. 


25. Hardware unrecoverable input error support 
Enter Yes to permit the full duplex terminal driver to pass 
characters received after a hardware error to the soliciting 
task, with notification. 

26. Device independent cursor positioning 
Enter Yes to permit cursor positioning coordinates without 


specifying terminal-type; the full duplex terminal driver 
determines terminal-type. 


4.5 SUMMARY OF PERIPHERAL QUESTIONS 


The following list comprises the possible peripheral questions for 
SYSGEN Phase I. Read Chapter 5 for details on the peripheral 
questions and the SYSGEN prompt lines. 


Enter [L/R,] vector, CSR for: 
l. CR Controller 0 [D: 230,177160] 
Respond with a carriage return to use the default vector and 
CSR assignments for the first CRll card reader. You must 


enter the vector and CSR addresses of subsequent CR11 
controllers. 
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CT Controller 0 [D: 260,177500] 


Carriage return uses the default vector and CSR assignments 
for the first TAll cassette controller. Subsequent TAI11 
controllers do not have default assignments. 


DF Controller 0 [D: 204,177460] 


Carriage return uses the default vector and CSR assignments 
for the first RFll controller. Subsequent RF11l controllers 
do not have default assignments. 


MS Controller 0 [D: 224,172522] 


Carriage return uses the default vector and CSR assignments 
for the first TS11 controller. Subsequent TS11 controllers 
do not have default vector assignments. 


PP Controller 0 [D: 74,177554] 


Carriage return uses the default vector and CSR assignments 
for the first PCll controller. Subsequent PCll controllers 
do not have default assignments. See Chapter 5. 


PR Controller 0 [D: 70,177550] 


Carriage return uses the default vector and CSR assignments 
for the first PC11/PR11 controller. Subsequent controllers 
do not have default assignments. See Chapter 5. 


UD Controller 0 [D: 234,171776] 


Carriage return uses the default vector and CSR assignments 
for UDC11, Universal Digital Controller. 


XB Controller 0 [D: 124,172414] 


Carriage return uses the default vector and CSR assignments 
for the first DAl11-B parallel line interface controller. 
Subsequent DA11-B controllers do not have default 
assignments. 


Enter [L/R,] vector, CSR, number of drives, unit number of first drive, 


2. 


[O=offset recovery support/NO=no support] for: 
DB Controller 0 [254,176700,,0,0] 


Enter two commas (,,) followed by the number of disk drives 
for the first RH11 or RH70 controller. This will use the 
default vector and CSR assignments, specify 0 as the unit 
number of the first drive, and include offset recovery 
support. Subsequent controllers default only the unit number 
of the first drive (to 0). 
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DR Controller 0 [D: 254,176700,,0,0] 


Enter two commas (,,) followed by the number of disk drives 
for the first RH11 or RH70 controller. This will use the 
default vector and CSR assignments, specify 0 as the unit 
number of the first RMO2 or RMO3 drive, and include offset 
recovery. Subsequent controllers default only the unit 
number of the first drive (to 0). 


Enter [L/R,] vector, CSR, number of drives for: 


376 


DD Controller O [D: 300,176500] 


Enter two commas (,,) followed by the number of drives’ for 
the first TU58 controller. This will use the default vector 
and CSR assignments’) for the DECtape II controller. 
Subsequent TU58 controllers do not have default responses. 


DL Controller 0 [D: 160,174400]} 


Enter two commas (,,) followed by the number of drives for 
the first RL11 controller. This will use the default vector 
and CSR assignments for the RLO1 cartridge disk controller. 
Subsequent RL11 controllers do not have default responses. 


DP Controller 0 [D: 254,176714] 


Enter two commas (,,) followed by the number of drives. for 
the first RP1ll controller. This will use the default vector 
and CSR assignments for the RP02/03 disk controller. 
Subsequent RP11 controllers do not have default responses. 


DT Controller 0 [D: 214,177342] 


Enter two commas (,,) followed by the number of drives for 
the first TCll controller. This will use the default vector 
and CSR assignments for the DECtape controller. Subsequent 
TCll controllers do not have default responses. 


DX Controller 0 [D: 264,177170} 


Enter two commas (,,) followed by the number of drives. for 
the first RX1l controller. This will use the default vector 
and CSR assignments for the RX0l floppy disk controller. 
Subsequent RX11 controllers do not have default responses. 


DY Controller 0 [D: 264,177170] 


Enter two commas (,,) followed by the number of drives’ for 
the first RX211 controller. This will use the default vector 
and CSR assignments for the RX02 floppy disk controller. 
Subsequent RX211 controllers do not have default responses. 


MM Controller 0 [D: 224,172440] 


Enter two commas (,,) followed by the number of drives. for 
the first RH11, RH70, TMO2, or TMO3 controller. This will 
use the default vector and CSR assignments for the first 
TU45, TU16, TE16, or TU77 magtape controller. Subsequent 
controllers of this type do not have default responses. 
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MT Controller 0 [D: 224,172522] 


Enter two commas (,,) followed by the number of drives for 
the first TMl1l1, TMA11, or TMB11 controller. This will use 
the default vector and CSR assignments for the first TS03, 


TU10, or TE1O magtape controller. Subsequent controllers of 
this type do not have default responses. 


Enter [L/R,] vector, CSR, F=full duplex/H=half duplex, 


E=error detec. unit/NO=no, C=char. detec unit/NO=no, 
number of syne characters in leader for: 


XQ Controller [D:,,H,E,C] 


Enter the vector address (from floating vector space starting 
at 300), the CSR address (from floating address space 
starting at 160010), followed by four commas (vector, 
CSR,,,,) and the number of sync characters in a syne leader 
for the first DQ11 synchronous line interface. This will 
specify a half duplex line with error and character detection 
units. Subsequent DQlls default half duplex and error and 
character detection unit specification. 


Enter [L/R,] vector, CSR, number of drives, unit number of first drive 


5. 


DS Controller 0 [D: 204,172040,,0) 


Enter two commas (,,) followed by the number of RS03/04 
drives for the first RH11 or RH70 controller. This will use 
the default vector and CSR assignments and specify 0 as_ the 
unit number of the first RS03/04 drive. Subsequent 
controllers default only the unit number of the first drive 
(to 0). 


Enter [L/R,] vector, CSR, highest unit number <0 to 7> for: 


6. 


DK Controller 0 [D: 220,177404] 


Enter two commas (,,) followed by the highest unit number 
(the number of RKO5 drives minus one, if you want the first 
unit number to be 0) for the first RK11 controller. This 
will use the default vector and CSR assignments for the RKOS 
disk controller and, assign 0 as the unit number of the first 
drive if you enter number of drives minus one for highest 
unit number. Subsequent RK11 controllers do not have default 
responses. 


Enter vector, CSR, VT11/VS60, number of CRT monitors for: 


7. 


GR Controller O [(D: ,172000,,1] 


You must enter the vector address and whether the connected 
terminal(s) is a VTll or a VS60; the CSR address and the 
number of CRT monitors default to 172000 and 1 respectively. 


for: 
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Enter [L/R,] CSR, number of A/D channels for: 


8. 


AD Controller 0 [D: 176770] 


Enter a single comma (,) followed by the number of A/D 
channels for the first ADO1-D analog-to-digital converter 
controller. This will use the default CSR assignment for the 
controller. Note that this device is used in non-interrupt 
mode and therefore, does not use an interrupt vector address 
assignment. The CSR address does not default for subsequent 
ADO1-D controllers. 


Enter [L/R,] vector, CSR, number of A/D channels for: 


9. 


AF Controller 0 [D: 134,172570] 


Enter two commas (,,) followed by the number of A/D channels 
for the first AFCll analog-to-digital converter controllers, 
This will use the default vector and CSR assignments for the 
AFC11 controller. Subsequent controllers do not have default 
responses. 


Enter [L/R,] clock vector, CSR, polarity mask, D=D/A channel/NO=no, 


10. 


Enter [L/R,] clock vector, CSR, #A/D channels, G=gain ranging option/NO=no, 


ll. 


maximum number of samples/second, DRK=DR11-K/NO=no 
(,DR11-K CSR) for: 


AR Controller 0 [D: ,170400,,,,,170420] 


Enter the clock vector address (from floating vector space 
starting at 300), a comma (,) to use the default CSR address, 
the polarity mask word, whether or not a D/A channel is 
present, the maximum number of samples per second, whether or 
not the DR11-K option is present, and, if present, a comma 
(,) to use the default CSR address for the DR11-K. 
Subsequent AR11 controllers default only the CSR address of 
the DRLI-K options. 


polarity mask, bandwith filter channel select delay, 
number of D/A channels, D=digital I/0 option/NO=no, 
maximum number of samples/second for: 


LS Controller 0 [D: ,170400,,,0,0,0,NO] 


Enter the clock vector address (from floating vector space 
starting at 300), a comma (,) to use the default CSR address, 
the number of A/D channels, whether or not the gain ranging 
option is present, four commas (,,,,) (to specify 16 bi-polar 
channels, no bandwith filter delay, no D/A channels, and no 
digital I/O option), followed by the maximum number of 
Samples per second for the first LPS11l controller. 
Subsequent LPS11 controllers do not default the CSR address. 
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Enter [L/R,] vector, CSR (, number of UMRS) for: 


12. 


LA Controller 0 [D: 300,170460,0] 


Enter two commas (,,) for the first LPAl1 controller. This 
will use the default assignments and excludes LPA11-K UNIBUS 
Mapping Register support. 


Enter [L/R,] vector, CSR, # drives, O=offset recovery/NO=no offset rec 


13 e 


DM Controller 0 [D: 210,177440,,0] 


Enter two commas (,,) followed by the number of drives’ for 
the first RK611 controller. This will use the default vector 
and CSR assignments for the RKO6/07 disk controller. and 
include offset recovery Support. Subsequent RK611 
controllers do not have default responses. 


Enter [L/R,] vector, CSR, F=full duplex/H=half duplex, 


14. 


14. 


14. 


14. 


number of characters in sync leader for: 
XL Controller O [D: ,,H]} 


Enter the vector address (from floating vector space), the 
CSR address (from floating address space starting at 175610), 
whether the line is half duplex or full duplex (the default 
is half duplex), and the number of syne characters in a syne 
leader for the first DLI1-E interface. Subsequent DL11-Es do 
not have a default response. 


XP Controller 0 [D: ,174770,H] 


Enter the vector address (from floating vector space starting 
at 300) followed by two commas (,,) and the number of sync 
characters in a sync leader for the first DPll interface. 
This will use the default CSR assignment and specify a half 
duplex line. Subsequent DPlls default only the half duplex 
parameter. 


XU Controller O [D: ,,F] 


Enter the vector address (from floating vector space starting 
at 300), the CSR address (from floating address space 
starting at 160010), whether the line is half duplex or full 
duplex (the default is full duplex), and the number of sync 
characters in a syne leader for the first DU11 line 
interface, Subsequent DUlls default only the full duplex 
parameter. ; 


XW Controller 0 [D: ,,H] 


Enter the vector address (from floating vector space starting 
at 300), the CSR address (from floating address space 
starting at 160010), whether the line is half duplex or full 
duplex (the default is half duplex), and the number of sync 
characters in a syne leader for the first DUP11 line 
interface. Subsequent DUPlls do not have default responses. 


for: 
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Enter [L/R,] vector, CSR, F=full duplex/H=half duplex/P=primary HDX for: 


15. XM Controller 0 


Enter the vector address (from floating vector space starting 
at 300), the CSR address (from floating address space 
starting at 160010), and whether the line is full duplex or 
half duplex for the first DMC11 interprocessor link. Note 
that if the line is half duplex and the primary station, you 
Must enter P. 


Enter [L/R] vector, CSR, printer type 
(, [KMC timeout count <0=no KMC>, KMC vector, KMC CSR]) for: 


16. LP Controller 0 [D: 200,177514,LA180,0,300,160130] 


Enter three commas (,,,) for the first LPll controller. This 
will use the default vector and CSR assignments and exclude 
KMC line printer support. 


Enter number of modules, module number of first for: 


17. UD Controller 0 ADUO] analog input module 
17. UD Controller analog output module 

17. UD Controller bi-stable output module 
17. UD Controller digital interrupt module 
17. UD Controller digital sense module 

17. UD Controller I/O counter module 

17. UD Controller single-shot output module 


oooocne 


The UDC1l1 supports seven modules; enter the number of each 
module and the module number of the first, 


Enter [L/R,] terminal number to redirect to (TTn:) for: 
18. CO Controller O [D: 0] 


Carriage return uses TTO: as the terminal for the console 
output driver. 


Enter [L/R,] NUM. DL11's <ZL>, NUM. DH11l's, NUM. DZ1ll's, NUM. DJ1l's for: 
19. The terminal driver [D: 1,0,0,0] 


Enter carriage return to specify that you have one DL1l 
asynchronous line interface. 


Note that this question appears only if you selected the user 
oriented or the baseline terminal drivers; the full duplex 
terminal driver is always loadable. 
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Enter NUM. DL1l's <ZL>, NUM. DH11'S, NUM. DZ11'S, NUM. DJl1l's for: 


20. 


The terminal driver [D: 1,0,0,0} 


Enter carriage return to specify that you have one DLil 
asynchronous line interface. This question appears only if 
you selected the full duplex terminal driver. 


Enter vector, CSR for: 


21. 


ZL Controller 0 [D: 60,177560} 


Carriage return uses the default vector and CSR assignments 
for the first DL11 asynchronous line interface. Subsequent 
DLlls do not have default responses. 


Enter vector, CSR, highest line number <0 to 15> 


22. 


(,answer speed, DM11-BB vector, DM11-BB CSR) for: 
DH Controller 0 [D: ,,,300,0,0] 


Enter the interrupt vector address (from floating vector 
space), the CSR address (from floating address space), and 
the highest line number (0=one line, 15=sixteen lines). This 
will exclude DM11-BB support for the first DH11 interface. 
I£ the DH11 includes DM11-BB modem support, you must also 
enter the answer speed (300 is the default), the DM11-BB 
interrupt vector address (from floating vector space), and 
the DMl1-BB CSR (from floating address space). Subsequent 
DHl1ls do not have default responses. 


Enter vector, CSR, highest line number <0 to 15> for: 


23. 


DJ Controller 0 


Enter the interrupt vector address (from floating vector 
space), the CSR address (from floating address space), and 
the highest line number (O=one line, 15=sixteen lines) for 
the first DJ11 multiplexer. 


Enter vector, CSR, highest line number <0 to 7> [,answer speed] for: 


24, 


DZ Controller 0 [D: ,,,0] 


Enter the interrupt vector address (from floating vector 
space), the CSR address (from floating address space), and 
the highest line number (O=one line, 7=eight lines) for the 
first DZ11 multiplexer. This will exclude DZ11l modem 


support. If you wish modem support, enter the answer speed 
baud rate. 


If 
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you selected an MM device, SYSGEN requests’ the 


number as follows: 


Tf 


If 


If 


If 


If 


If 


Tf 


TM02/03 


51. MM controller 0 unit 0. formatter [D R:0-7 D:0] 


The default is unit number 0. 


you selected a DB device, SYSGEN requests drive 


type 


52. Contr 0 unit 0. is an RP04,05/RP06 [D:RP06] 


The default is RPO6. 


you selected a DL device, SYSGEN requests drive 
53. Contr 0 unit 0. is an RLO1/RLO2 [D:RLO1] 


The default is RLO1l. 


you selected a DM device, SYSGEN requests drive 
54. Contr 0 unit 0 is an RKO6/RKO7 [D:RK06] 


The default is RKO6. 


you selected a DP device, SYSGEN requests drive 
55. Contr 0 unit 0 is an RPO2/RPO3 [D:RP03] 


The default is RPO3. 


you selected a DR device, SYSGEN requests drive 
56. Contr 0 unit 0 is an RMO2/RMO3 [D:RM03] 


The default is RMO3. 


you selected a DS device, SYSGEN requests drive 
57. Contr 0 unit 0. is an RSO3/RS04 [D:RS04] 


The default is RSO4. 


you selected a DY device, SYSGEN requests drive 
58. Contr 0 unit 0. is SINGLE/DOUBLE density 


You must specify whether the RX02 drive 
double density. 


type 


type 


type 


type 


type 


as 


as 


as 


as 


as 


as 


density 


is 


at 


formatter 


follows: 


follows: 


follows: 


follows: 


follows: 


follows: 


as follows: 


single or 
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If you selected ICS/ICR subsystems or DSS/DRS modules, SYSGEN asks the 
following questions. 


ie 


Expanded comments for ICS/ICR questions 
Enter Yes for explanatory text. 
Do you want task activation from unsolicited interrupts 


Enter Yes to permit the driver to initiate a task when the 
driver receives unsolicited input. 


IC controller 0 vector address 


Enter the interrupt vector address. The standard is 234. 
The acceptable range is 234-774. 


CSR address 


Enter the CSR address. The standard is 171776. The 
acceptable range is 160000-177700. 


Is it an ICR-11 

Enter Yes to specify an ICR-1ll, No to specify an ICS-1l. 
Number of A/D converter modules in this ICS/ICR 

Enter the number of modules in the range 0-16. 

A/D converter module number 

Enter the A/D converter module number in the range 0-35. 
Number of expansion multiplexers 


Enter a value in the range 0-7. 


The ICS/ICR subsystem consists of six modules. SYSGEN requests’ the 


number 


of modules (questions 12-17) and the module number of each 


(question 9). 


ig. 


13. 
14. 


ll. 


Number of D/A converter modules in this ICS/ICR 
Number of single-shot output modules in this ICS/ICR 
Number of bi-stable output modules in this ICS/ICR 
Number of digital sense modules in this ICS/ICR 
Number of digital interrupt modules in this ICS/ICR 
Number of I/O counter modules in this ICS/ICR 
(module name) module number 

Restore module status on power and error recovery 
Enter Yes to select this option. 

How many line errors are acceptable per second 


If you selected option 10, enter a value in the range 0-5000. 
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18. Expanded comments for DSS/DRS questions 
Enter Yes for explanatory text. 
19. Number of DRS-11 modules 
Enter a value in the range 0-16. Questions 20, 21, and 22 
pertain to DRS-11 modules; if you enter 0, these are 
omitted. 
20. Restore module status on power and error recovery 
Enter Yes to select this option 
21. DRS-11 CSR address 
Enter a value in the range 160000-177700. 
22. DRS-11 vector address 
: Enter a value in the range 300-774. 
23. Number of DSS-11 digital input modules 
Enter a value in the range 0-16 minus the response to 
question 19. 
24. DSS-11 CSR address 
Enter a value in the range 160000-177700. 
25. DSS-11 vector address 
Enter a value in the range 300-774. 
26. Task activation from unsolicited interrupts 
Enter Yes to select this option. 
If your system includes IP11/IP300 support, SYSGEN asks the following 
questions. 
1. Extended comments for IP11/1IP300 
Enter Yes for explanatory text. 
2. Treat all controllers as one unit 
Enter Yes to generate a single SCB and UCB for all 
controllers. 
3. Any latching digital output modules 
Enter Yes to include support in driver. 
4. Any single-shot output modules 


Enter Yes to include support in driver. 


10. 


ll. 


12. 


13. 


14. 


15. 


16. 


17. 


18. 
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Direct output via QIO 

Enter Yes to simplify coding, but increase overhead. 
Any non-interrupting digital sense modules 

Enter Yes to assemble code for this module. 

Any interrupting digital sense modules 

Enter Yes to assemble code for this module. 

Any change-of-state modules 

Enter Yes to assemble code for this module. 

Any counter modules 

Enter Yes to assemble code for this module. 

Direct input via QIO 

Enter Yes to simplify task code at the expense of overhead. 
Unsolicited interrupt support 


Enter Yes and tasks can monitor unsolicited interrupts from 
the interrupting modules, 


Event flag linkage to interrupts 


Enter Yes to permit tasks to monitor digital interrupts 
through event flags. 


Any D/A converters 

Enter Yes to assemble code for this module. 

Any A014 A/D converters 

Enter Yes to assemble code for this module. 

Any A020 A/D converters 

Enter Yes to assemble code for this module. 

How many output bytes should be saved on powerfail 
Enter a value in the range 0-3048(10). 

IP1l1l vector 


Enter a value in the range 60-774. The standard vector is 
234. 


Base address 
Enter the IP11 base address (base address is CSR minus 377 


octal). The default for the first controller is 171000 and 
171400 for the second. Acceptable range is 160000-177400. 


“ 


CHAPTER 5 


DETAILS OF SYSGEN PHASE I 


This chapter contains detailed descriptions of SYSGEN Phase I 
questions by sections. The phase 1 sections are: 


Setup Questions 

Target Questions 

Host Questions 

Executive Questions 
Terminal Driver Questions 
Peripherals Questions 


The questions are listed in numeric. order. Not all the questions 
appear; the order of the questions is based on your responses. Also, 
the peripherals section follows a strict numeric order, not logical 
sequence, 


Figure 5-1 shows the processing steps that take place during SYSGEN 
Phase I, 
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Figure 5-1 Processing Steps in SYSGEN Phase I 
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Step 1 in Figure 5-1 is invoking SYSGEN, as described in Chapter 3. 


Step 2 in Figure 5-1 is answering the questions in each of the 
sections in SYSGEN Phase I. For this process, you can answer all 
the questions explicitly at your terminal, you can use saved 
answers, or you can use a combination of saved answers and 
explicit answers. 


As you answer the Phase I questions that define your system, 
SYSGEN is building files that correspond to your answers. These 
files are the output of SYSGEN Phase I: 


SYSSAVED SYSSAVED is the file that contains symbols that 
correspond to your answers to SYSGEN Phase I questions. 
SYSSAVED.CMD is used as input to later SYSGENs. 
SYSSAVED.DAT is the output from a SYSGEN. 


RSXMC.MAC RSXMC.MAC is the assembler source file that comprises 
the executive features defined during SYSGEN Phase I. 
This file is assembled in Step 3. 


SYSTB.MAC SYSTB.MAC is the assembler source file that contains 
the data structures for devices selected during SYSGEN 
Phase I. 

RSXASM.CMD RSXASM.CMD is the command file that controls assembly 


of the executive. 


RSXDRVASM.CMD RSXDRVASM.CMD is the command file that controls 
assembly of the device drivers. 


RSXBLD.CMD RSXBLD.CMD is the command file that controls the task 
building of the executive. 


SGNPARM.CMD SGNPARM.CMD is the RSX-11M indirect command processor 
file that contains symbols defined in SYSGEN Phase I 
for use in controlling SYSGEN Phase II processing. 

ICTAB.MAC ICTAB.MAC contains the ICS/ICR data structures. 


Step 3 in Figure 5-1 is the assembly of the executive, device drivers, 
terminal driver, and privileged tasks. 


Input to Step 3 is output of Step 2; refer to description of 
those files above. 


SYSGEN controls the assembly and creates an object file that 
corresponds to the system you defined in Step 2. 


If all assemblies are successful, SYSGEN completes execution and 
displays the <EOF> prompt. 


5.1 SYSGEN SETUP QUESTIONS 


The SYSGEN Phase I setup section asks questions that provide SYSGEN 
with information describing the way you want the program to execute, 
input to SYSGEN, and what kind of output you want from SYSGEN. 


ad 


ws 
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SYSGEN asks a series of questions that define whether to: 
@ Execute MCR commands 
e Use saved answers as input to SYSGEN 
e Use breakpoints 


When you are generating a system for the first time, you may wish to 
follow the logical flow through the SYSGEN command files. For this 
case, the setup section of SYSGEN asks the question: 


* 1, Do you want to inhibit the execution of MCR commands [Y/N]: 


An affirmative response to this question prevents SYSGEN from creating 
or deleting files as well as inhibiting MACRO-11 and the Task Builder 
execution, UIC modification, device mounting, and logical assignments. 


When you inhibit MCR commands, SYSGEN asks all Phase I questions as 
usual, and creates SYSSAVED.DAT if you request it, but doesn't execute 
MCR commands required to build a system. 


This feature allows you to practice the system generation to see how 
SYSGEN asks questions and to plan the way you want to answer questions 
when MCR commands are not inhibited in later system generations. 


SYSGEN provides breakpoints, or pauses in execution, during system 
generation. There are three types of breakpoints: 


e End-of-Section (EOS) Breakpoints 
@e End-of-Execution (EOX) Breakpoints 
@ End-of-Disk (EOD) Breakpoints 


These breakpoints are used for various purposes, but can be overridden 
so that SYSGEN can execute unattended when that is appropriate. 


End of section breakpoints are pauses at the end of each section of 
SYSGEN dialogue questions. In SYSGEN Phase I, there are six sections 
of dialogue questions. You can choose to answer the questions in all 
sections without interruption or you can direct SYSGEN to pause after 
you answer each section. This breakpoint in the dialogue gives you 
the opportunity to: 


@ Continue the dialogue 

@e Repeat the section of question, perhaps to correct previous 
answers 

@ Exit the SYSGEN program 

e Suspend execution of the SYSGEN program (.PAUSE) 


Note that if you type CTRL/Z in response to any question, SYSGEN exits 
cleanly (for example, closes all files), 


Figure 5-2 shows where End-of-Section breakpoints occur in the flow of 
SYSGEN Phase I. 


Execution breakpoints (EOX) in the SYSGEN procedure occur after 
completion of a MACRO assembly or a Task Build operation. SYSGEN can 
pause at these points to ensure successful completion of the assembly 
or build operation. When you know files will execute successfully, 
you can direct SYSGEN to continue processing without the breakpoint 
pause. , 
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Figure 5-2 shows where End-of-Execution breakpoints occur in the flow 
of SYSGEN Phase I. 
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Figure 5-2 End-of-Section and End-of-Execution Breakpoints in 
the Flow of SYSGEN Phase I 


As shown in Figure 5-2, a flow of execution through SYSGEN Phase I can 
be interrupted by end-of-section breakpoints, During Phase II, SYSGEN 
execution can be interrupted by end-of-execution breakpoints. You can 
direct SYSGEN to override these breakpoints and execute unattended by 
means of questions asked in the setup section of SYSGEN Phase I. 


DETAILS OF SYSGEN PHASE I 


End-of-disk breakpoints (EOD) occur in system generations with RKO5 
distribution kits. After SYSGEN completes processing with the EXCSRC 
volume in the RKOS kit, SYSGEN prompts you for the next disk required: 


* EOD * If not in [dduu:], enter driver source files device 
(dduus ) ‘. 


At this point, you remove EXCSRC from the drive and replace it with 
DRVSRC. 


In the same cases, where your configuration includes more than two 
drives, you can override EOD breakpoints to run SYSGEN unattended. 


Parts I, II, and III of SYSGEN all reside in UFD [200,200]. However, 
while it executes, SYSGEN resets the UIC under which it runs to store 
files in appropriate UFD's. 


When you stop SYSGEN execution, for any reason, and want to resume 
execution later, ensure that you set your UIC to [200,200]. 


The following is a list of the questions. 
* 1. Inhibit MCR command lines (Type <ESC> for explanation) 


This option permits you to perform a PREPGEN; the SYSGEN 
questions are asked in the logical order (based on your 
responses), but SYSGEN inhibits the processing of MCR commands and 
commands that assemble, build, create, or delete files. A PREPGEN 
permits you to follow the logical flow of a SYSGEN and helps 
familiarize you with the questions specific to your SYSGEN. Also, 
a PREPGEN allows you to schedule actual SYSGEN processing; you 
perform a PREPGEN, save the responses (answer Yes to setup 
question 10), and then submit the saved answer file for SYSGEN 
processing at your convenience. 


NOTE 


To successfully complete a PREPGEN, you 
Must mount all required volumes as well 
as establish logical assignments’ for 
pseudo devices SY: and LB:. Refer to 
Chapter 3. 


If you respond Yes, SYSGEN asks Setup Question 3; if you respond 
No, SYSGEN asks Setup Question 2. 


* 2, Have you made a copy of the distribution kit 
A copy of the distribution kit insures that you have a backup copy 
in case you inadvertently delete important files or data during 
the system generation process. Also, a backup copy serves as a 


base for future updates. 


If you answer this question No, SYSGEN displays the message: 


SGN -- You are or will be running on the original copy of the 
distribution kit. Make a copy via the standard procedure and 
restart. 


SYSGEN then exits to allow you to copy the media. 


5-5 
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* 3. Use saved or canned answer file for input responses 


This question permits you to direct SYSGEN to use a saved answer 
file (either a canned or a SYSGEN created one) as input. If you 


respond Yes, SYSGEN 


uses a file named SYSSAVED.CMD to obtain 


responses to questions. Note that SYSGEN does not save responses 
for ICS/ICR, DSS/DRS, or IP11/IP300 devices; you must enter the 
responses for these . devices. Question 10 provides details 
concerning saved answer files. 


If you respond Yes, 


re-answer the host 


SYSGEN asks you whether or not you want to 
or device configuration questions and bypass 


breakpoints in Setup Questions 4, 5, 6, 7, and 8: these questions 


provide options for 


use with saved answers. If you respond No and 


you are using the RKO5 kit, SYSGEN asks question 9; for other 
kits SYSGEN asks question 10. 


* 4, Undefined answer wakeup 


This feature causes the terminal bell to ring when SYSGEN 
encounters an undefined symbol when using the saved answer file 
SYSSAVED.CMD (SYSGEN precedes the question with a CTRL/G). 


This question is asked only if you responded Yes to question 3 


(Use saved answers). 


* 5. Use saved host configuration 


This question allows you to use previously-defined (saved) answers 
to host section questions. In the case where you are running 
SYSGEN online and already have all the listings you need, you may 


want to redefine 


the host answers in the saved answer file 


(SYSSAVED.CMD) to redefine the way SYSGEN handles’ listings. An 
affirmative response implies that you are performing a SYSGEN on 
the same, or similar, configuration you used to create the saved 


answer file. 


This question is asked only if you responded Yes to question 3 


(Use saved answers). 


* 6. Use saved peripheral configuration 


This question provides you the opportunity to use the 


previously-defined 


(saved) peripheral configuration contained in 


the file SYSSAVED.CMD. 


If you respond Yes 


to this question, SYSGEN uses the saved 


peripheral configuration specified by the symbols SDEV, $DV2, and 
S$DV3. If you respond No, SYSGEN asks Executive question 16. Note 
that a negative response does not affect the saved answers and 


does not permit you 
defined devices. 


to change vectors or CSRs of previously 
A negative response permits you to change only 


the number of controllers; respond No to add or delete 


controllers. 


This question is asked only if you responded Yes to question 3 


(Use saved answers). 
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* 7, Skip end of section (EOS) breakpoints 


This question allows you to choose whether or not to skip 
End-of-Section (EOS) breakpoints. At these breakpoints, you can 
select whether to continue SYSGEN questions, repeat questions in 
the preceding. sections (to correct wrong answers), exit from 
SYSGEN, or cause SYSGEN to pause. This feature is also one which 
in combination with other features defined in this section, allows 
you to run unattended SYSGENs. 


Breakpoints occur at the following points in SYSGEN Phase I: 


e After the Target and Host section 
e After the Executive and Terminal Drivers section 
e After the Peripherals questions 


If the answers in SYSSAVED.CMD already define the system you want 
to generate, you can direct SYSGEN to complete execution of Phase 
I without interruption by answering Yes to this question. 


Note that the laboratory and I/O peripherals questions cannot be 
repeated (as can Executive questions). However, if you specify 
repeat at the EOS breakpoint, SYSGEN renames SYSSAVED.DAT to 
SYSSAVED.CMD so that you can continue where you left off. 


This question is asked only if you responded Yes to question 3 
(Use saved answers). 


* 8. Skip end-of-execution (EOX) breakpoints 


End-of-Execution (EOX) breakpoints occur after the MACRO-11 
assembler and the Task Builder complete execution. If you know 
that processing will complete successfully, answer Yes to direct 
SYSGEN to process without pausing at completion of MACRO-11 or 
Task Builder execution. 


If you answer No, SYSGEN pauses after execution of these tasks to 
allow you to check and correct the results. 


This question is asked only if you responded Yes to question 3 
(USe Saved answers). 


* 9, Skip end of disk (EOD) breakpoints 


The dual RKOS distribution kit imposes a breakpoint when you must 
change disks after assembling the Executive. You must swap the 
EXCSRC disk with the DRVSRC disk to assemble the device drivers. 


An affirmative (Yes) response to this question implies that a 
third disk drive is available and that the drive contains the 
driver source files. Thus, SYSGEN can assemble the Executive, 
using the EXCSRC disk, and then assemble the device drivers, 
without interruption, using the drive that contains the driver 
source files. I£ you respond Yes to this question, you are asked 
(in question 15) to identify the device that contains the driver 
source files. Note that this device can be a third RKO5 drive or 
a drive of a different type. (If a drive of a different type is 
used, the volume must completely contain the contents of the 
DRVSRC disk. Also, the driver must be loaded and you must mount 
the volume.) 
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* 10. Save responses (i.e.: create SYSSAVED.DAT) 


When you respond Yes to this question and request a saved answer 
file, SYSGEN creates an indirect command file named SYSSAVED.DAT. 
This file consists of .SET directives which assign values to the 
symbols defined by your responses to SYSGEN questions (indirect 
command file processor directives are described in the 
RSX-11M/M-PLUS MCR Operations Manual). For example, when you 
enter a processor type in response to target question 1 (such as 
11/70), SYSGEN writes the following line to the file SYSSAVED.DAT: 


eSETS $TPR "11/70" 


Appendix A lists all the symbols that SYSGEN defines in a _ saved 
answer file and identifies the option that each symbol represents. 
You can then use the saved answer file as input to a later SYSGEN 
simply by renaming the file to SYSSAVED.CMD and responding Yes to 
question 3. Thus, saved answer files permit you to generate 
duplicate or similar systems without the need to answer the SYSGEN 
questions, 


More importantly, you can edit the SYSSAVED.DAT file to correct an 
errant response or to alter specific system characteristics. For 
example, you generate a system, but do not include 20K Executive 
support and then find you need more DSR space. The saved answer 
file permits you to generate the same system, except with support 
for a 20K Executive; simply edit SYSSAVED.DAT and set symbol $20K 
to true (.SETT $20K). Then rename SYSSAVED.DAT to SYSSAVED.CMD 
and submit the command file as input to SYSGEN. All the options 
you included in the 16K Executive system are then included in the 
20K Executive system. To correct an errant response, enter Exit 
at the next end-of-section breakpoint or respond with CTRL/Z to 
any question (CTRL/Z closes SYSSAVED.DAT and exits SYSGEN). You 
can then edit and rename the command file and restart SYSGEN. 


If you alter specific system characteristics, be sure to read the 
detailed description of those options/features. Some options, 
like cat and mouse, are mutually exclusive and some options 
require or automatically include other options. 


Note that in extreme cases where you change the system complexion, 
it is more practical to perform a complete SYSGEN rather than 
attempt to edit the saved answer file. For example, do not toggle 
the settings for $115 or S$MAP, since these symbols effect 
system-wide characteristics. 


You can delete any number of responses in SYSSAVED.CMD; SYSGEN 
asks the respective question when a symbol is missing from the 
saved answer file. In this case, it is especially useful to 
specify undefined answer wakeup (respond Yes to question 4). 


NOTE 


SYSGEN does not save answers for 
DRS/DSS, ICS/ICR, or IP11/IP300 devices. 
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* 11. UIC for SYSSAVED files if not [defaultuic] 


If you want to use saved answer files, enter the UIC of the saved 
answer file you are using or will create. In certain cases, you 
May want to have features for various systems, each system created 
under a different UIC. 


If you respond with a carriage return, SYSGEN uses your. current 
UIC for saved responses. Otherwise, enter the UIC under which you 
want responses saved. 


* 12. UIC for SYSGEN command files if not [sysgenuic] 


This question allows you to select the UIC under which SYSGEN 
looks command files. 


If you are not inhibiting MCR lines, sysgenuic is [200,200]. If 
you are inhibiting MCR lines, sysgenuic is the same as the default 
UIC of the terminal when you invoke SYSGEN. 


* 13. Clean up files from previous GENs 


In cases where you are generating multiple systems on the same 
media, SYSGEN creates files that may not be appropriate from one 
system to the next. This question gives you the opportunity to 
request that SYSGEN delete all such unnecessary files. 


This question is asked only if you respond No to Setup Question 1 
(Inhibit MCR commands). 


* 14. Device, when ready, for Executive sources (ddu:) [D:SY:]: 


Enter the device type and unit number (ddu:) for the unit 
containing the Executive source files (on volume EXCSRC), for 
example, DK1l:. The trailing colon is appended by SYSGEN when it 
is omitted. 


The default when you are using a big disk distribution kit is SY:. 


This question is always asked. 


NOTE 


If you are performing a PREPGEN, SYSGEN 
does not issue a Mount command for the 
Executive source device. (See Chapter 
3.) 


* 15. Device, when ready, for driver sources (ddu:) 


This question appears only if you are using the dual RKO5 
distribution kit and responded Yes to question 9 (skip end-of-disk 
breakpoints). 


Enter the device type and unit number (ddu:) for the unit 
containing the driver source files (DRVSRC), for example, DK3:. 
The trailing colon is appended by SYSGEN when it is omitted. 
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5.2 TARGET CONFIGURATION DEFINITION QUESTIONS 


This section of questions defines the processor type and options, 
system type, and peripheral devices included in the target system. 


* 1. Processor (e.g.: 11/34, LSI-11) [5:6] 
Enter the target processor type. 
Valid entries are: 


11/03 11/23 11/55 
11/04 11/34 11/60 
11/05 11/35 11/70 
11/10 11/40 LSI-11l 
11/15 11/45 
11/20 11/50 


This question is always asked. 


* 2. Does processor have a switch register 


The switch register is the register that contains the toggle 
settings on the front panel of your processor. Certain processors 
(the 11/34, for example) may have neither toggles nor a_ switch 
register. 


If your processor does not have a switch register, you are 
restricted from’ using the Executive directive, GSSWS (Get Sense 
Switch), which reads the contents of the switch register. 


This question appears only if your processor, as defined in Target 
Question 1, is a PDP-11/03, 11/04, 11/34, or 11/60. Other 
processors always include a switch register. 


* 3. Generating RSX-11S 


The answer to this question specifies whether you are generating 
an RSX-11M or RSX-11S system. 


This question is always asked. 


* 4, Memory size (in K-word blocks) [min:max] 


Enter the amount of memory for your processor in 1024-word blocks. 
The legal range is from 16K through 1920K; but depends on the 
minimum and maximum memory sizes for your processor. SYSGEN 
calculates the range values (min and max) based on your response 
to question l. 


The table below shows the minimum and maximum memory sizes for 
RSX-11M-supported PDP-11l processors. 


Note that memory size must be specified in 4K increments. 
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Processor Default Memory Size 
11M 118 

min max min max 
LSI-1l1, 11/03 not supported 8 28 
11/04 16 28 8 28 
11/05, 11/10 16 28 8 28 
11/15, 11/20 16 28 8 28 
11/70, 32 1920 32 124 
all others 16 124 8 124 


In the category "all others," above, the processors are _ the 
PDP-11/34, 11/35, 11/40, 11/45, 11/50, 11/55, and 11/60. 


NOTE 


If your processor is an 11/70 and you 
want the 22-bit addressing option, you 
must specify a memory size of 128K or 
greater. 


* 5. Mapped 


The answer to this question specifies whether the target system 
includes the Memory Management Unit (KT-11). If it does, enter 
Yes to generate a mapped system. This question is always asked. 


The memory size you specify in question 4 must be consistent with 
the mapping option; you must have at least 24K of memory to 
generate a mapped system and a maximum of 28K to generate an 
unmapped system. 


The LSI-11, PDP-11/03, 11/04, 11/05, 11/10, 11/15, and 11/20 
processors do not support mapped systems. 


You must answer Yes if your processor has more than 28K of memory. 
If you enter a memory size inconsistent with the mapping option, 
SYSGEN displays an error message and repeats both questions. 


I£ you respond Yes to this question, SYSGEN automatically includes 
Executive support for address checking and I/O rundown (see 
Executive questions 9 and 10). 


* 6. Any K-series laboratory devices 


The K=-series laboratory options are a set of real-time data 
acquisition modules which interface to the PDP-11 family of 
computers. 


Answer YES if you want support for the K-series software routines 
(see the RSX-11M/M-PLUS I/O Drivers Reference Manual). If you 
enter Yes, SYSGEN automatically includes connect to interrupt and 
AST and cancel selective marktime support. 


* 7, Extended arithmetic element (KE11-A/B EAE) present 


The extended arithmetic element (EAE) is a hardware feature that 
performs signed integer multiplication, division, 
multiple-position shifts, and normalization. The EAE performs 
these functions significantly faster than software subroutines. 
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This question is not asked if the processor has memory management 
and is not asked for non-UNIBUS PDP-lls (for example, the PDP11/03 
and LSI-~-11). 


* 8. Floating point processor (FP11l) present 


The PDP-1l1 floating point processor (FP11-A,C,E) performs all 
floating point arithmetic operations and converts data from 
integer to floating point format and vice versa. The FP11-A is 
available for the PDP-11/34 processor. The FP11-C is available on 
the PDP-11/45, 11/50, 11/55, and 11/70 processors. The FP11-E is 
available for the PDP-11/60 processor. Also, there is a floating 
point option for the 11/23 that is compatible with the FP1ll. 


This question does not appear for other processors. 


If the target processor is a PDP-11/60, floating point support is 
automatically included and the question is not asked. 


This feature should not be confused with the floating instruction 
set (FIS) available on the PDP-11/40 processor. 


If you respond No to this question, Target Question 9 is asked. 
If you respond Yes to this question, SYSGEN automatically includes 


Executive support for Asynchronous System Traps (AST support) (see 
Executive question 16). 


* 9, Floating instruction set (FIS) present 


The floating instruction set (FIS) feature includes hardware 
functions that perform floating point add, subtract, multiply, and 
divide instructions. This feature is available only on _ the 
LSI~11, PDP-11/03, and 11/40. 


This question is asked only if the target processor is one listed 
above. 


* 10. If using KW11-P as system clock: number of ints/sec.[0:1000.] 


RSX-l11M/S requires a real-time clock for operations. Three clocks 
are available: the KW1l1-P programmable frequency clock, the 
KWl1-L line frequency clock, and the DL1l1-w line frequency 
clock/console. If your system has a KW-11P and you want to use 
this clock as your system clock, the acceptable range is from 1 
through 1000. 


A response of 0 indicates there is no programmable clock in this 
configuration or that you want to use the line frequency clock. 


This question is not asked if your processor is the LSI-1ll, 
PDP-11/03, or PDP-11/23. 


The number of interrupts you select must be divisible evenly into 
10000. 


More than 100 (decimal) clock interrupts-per-second greatly 
increases system overhead; you should carefully consider the 
impact on your system before specifying a number greater than 100 
(decimal) per second. 
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* 11, Line frequency: A- 60 Hz B- 50 Hz [Default: "A"] 


You can specify a line frequency of either 50 or 60 hertz. In the 
USA, line frequency is always 60 hertz. The default response is 
60 hertz. 


This question is always asked. 


* 12. KW11-Y Watchdog timer support 


The KWll-Y watchdog timer is a hardware clock that constantly 
attempts to time-out system activity. The executive refreshes the 
timer at every clock interrupt. If the system faults or if a 
hardware failure occurs and the timer expires, a signal is 
generated to indicate that the system has been corrupted. 


This question is always asked. 

If you select this feature, the system you generate will run only 
on a configuration that includes the KW11-Y watchdog timer. If 
you attempt to boot your system on a configuration that does not 
include a KWll-Y¥ watchdog timer, the system crashes immediately. 


* 13, Memory parity support 


If your system includes parity memory and you want Executive 
Support to detect parity errors, enter Yes. 


This question is always asked. 

If you respond No to this question, Target Question 14 (cache 
memory) is not asked. If you respond Yes to this question, SYSGEN 
asks Target Questions 14 and 15. 


* 14. Cache memory 


Cache memory is available on PDP-11/34, 11/60, and 11/70 
processors. 


If your system ‘includes cache memory and you want Executive 
support to detect parity errors, enter Yes. 


This question is asked only for the processors listed above when 
you select memory parity support (Target Question 13) for those 
processors. 


*15. Highest interrupt vector (If 0 will be computed) [0:774] 
The response to this question specifies the highest interrupt 
vector address. I£ you respond 0 (or carriage return) or with a 
value less than 400, SYSGEN calculates this address based on your 
answers to the peripheral questions. 


This question is always asked. 


Enter a value greater than 400 if you require vector space for 
devices that will not be specified during this SYSGEN. 


* 16 
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SYSGEN does not 
SYSSAVED.DAT 


until you 


NOTE 


write this symbol to 


complete the 


peripheral section. 


- Devices 


This question 
peripherals 


allows you 


and pseudo-devices 


to enter, in mnemonic’ form, 


for your configuration. 


select the appropriate device mnemonic, enter an asterisk (*) 


generate a list 


vice 


Controller(s) 


AD01-D 

AFC11 

AR11 

CR11 CM11-F 
TA11 TU60 

RPO04 RPOS RPO6 
TU58 

RF1l 

RK11 RKO3 RKOS5 
RL11 RLO1 RLO2 
RK611 RKOG6 
RP11 RPO2 RPO3 
RMO2 RMO3 

RSO3 RSO4 

TCll TUS6 

RX1l1 RXO1 
RX211/RX02 
VTl1l vT60 

Ics ICR11 
IP11/1P300 

DRS DSS11 
LPA11 

LP LS LV11 LA180 
LPS11 

TU16 TU45 TU78 TE16 
TS04 

TM11 TU1O TE1O TSO3 
PC1ll 

PR11 PCcll 
UDC11 

DA11-B 

DL11-E 

DMC11-E 

DPll 

DQl11 

DULI 

DUP11 


of devices. The 
peripheral devices that RSX- 


following 
11M supports: 


Description 


Analog-to-Digital Subsystem 
Low Level Analog Input Subsystem 
Analog Real-Time Module 
Punched Card Reader 

Cassette Drive 

Disk Drive 

DECtape Drive 

Fixed-head Disk Drive 
DECpack Cartridge Disk Drive 
Disk Drive 

Disk Drive 

Disk Drive 

Disk Drive 

Fixed-head Disk Drive 
DECtape Drive 

Floppy Disk System 

Floppy Disk System 

Graphics Display System 
Subsystems 

Subsystems 

Subsystems 

Laboratory Peripheral Accelerator 
Line Printers 

Laboratory Peripheral System 
Tape Drives 

Tape Drive 

Tape Drives 

High-Speed Paper Tape Reader 
High-Speed Paper Tape Punch 
Universal Digital Control Subsystem 
Unibus Link 


Single Asynchronous Serial Line Interface 


Network Link 

Synchronous Line Interface 

NPR Synchronous Line Interface 
Synchronous Line Interface 


Synchronous Line Interface 


To help 


is a list of the 


5.3 
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Enter devices in the form: 
device [=controllers] 


where device is the device mnemonic and controllers is the number 
of controllers for the device type. Brackets denote an optional 
entry and are not part of the syntax. If you omit the controller 


entry (=controllers), SYSGEN assumes one controller’ for that 
device type. 


Terminate this question by entering a period(.) either following 
the last controller you enter or on a line by itself. 


Generally, there may be one controller for several devices of a 
given type. For example, four RKO5 drives can be connected to one 
RK11 controller. In this case, all you are required to enter in 
response to this question is DK; SYSGEN defaults to one 
controller for all four drives. 


If you make a mistake and specify a device type that is not 
included in the target configuration, enter device=0. Also, if 
you specify the wrong number of controllers, you can correct this 
by reentering; SYSGEN uses the most recent response for duplicate 
entries. For example, if your system includes two RK1l 
controllers (four RKO5 drives) and one TCll DECtape controller 
(two TU56 drives), the following sequence corrects an errant 
response of three RKlls, two TU58s, and one RLI11. 


Devices: DK=3 
Devices: DT=2 
Devices: DL 
Devices: DK=2 
Devices: DT 
Devices: DL=0 
Devices: 7 


NOTE 


To specify the number of paper’ tape 
device controllers, you must consider 
the number of PCll reader/punch and the 
number of PR11 readers. Enter the 
number of PClls as PP=n, where n is’ the 
number of PCll controllers. Enter the 
number of PR11 controllers as PR=k, 
where k is the number of PR11 
controllers plus n (the number of PCll 
controllers). For example, if your 
system includes one PCll and two PRIlls, 
enter the following: 


PP=1] 
PR=3 


HOST CONFIGURATION QUESTIONS 


This section of questions defines the configuration on which you are 
running SYSGEN. 
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* 1. Are you running SYSGEN standalone (on the baseline system) 


This question specifies whether you are running online or 
standalone. : 


If you respond Yes, SYSGEN assumes that you cannot spool listings 
and maps and does not ask Host Question 3. 


Note that if you are running SYSGEN online, you cannot direct 
listings or maps directly to the line printer (LP:). 


* 2. Is a line printer available 


This question is asked to allow you to specify the device to which 
maps and listings are sent (line printer if Yes, terminal if No). 


If you respond NO, you cannot specify that the line printer (LP:) 
is the listing device. 


* 3, Spool assembly listings and Executive and driver maps 


This question allows you to specify whether or not to _ spool 
listings. For example, you can direct listings to an intermediate 
device, If you want the listings spooled to the line printer 
respond Yes to this question. If you want to save the listings 
but not spool them, respond No to this question. 


* 4, Does the listing/map device have at least 120 columns 
If the listing device does not have at least 120 columns, SYSGEN 
creates a narrow listing file for map listings. For information 
on narrow listings, refer to the descriptions of the /LI_ switch 
for MACRO-11 and the /WI switch for the Task Builder. 
* 5, Assembly listing file device (ddu:) [D: "NL:"] 
This question allows you to choose whether or not to direct 
listings to an RSX-11M logical or pseudo device or to not generate 
them at all. 
Specify LP: to send the listings to the line printer if you are 
running standalone, to a disk device (dduu:) if you are running 
online, and NL: (the null device) to direct SYSGEN not to produce 
assembly listings. 
NOTE 
SYSGEN does not load the driver for the 
device you specify. 
* 6. Map device for Executive and device drivers (ddu:) [D: mapdevice] 


The response to this question defines the default device to which 
you want to direct the Executive and device driver maps. 


It is recommended that you specify a device for these maps. 


‘8 
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For unmapped systems, you should specify a device, since the maps 
are required to determine the size of the Executive and to layout 
memory partitions in SYSGEN Phase II. 


Note that you can override the device for driver maps in Phase II. 


5.4 EXECUTIVE QUESTIONS 


This section allows you to choose which of the RSX-11M Executive 
options you want included in your system. 


The RSX-11M/M-PLUS Executive Reference Manual fully describes these 


directives and Executive options. 


Answer Yes to the features you want included in your system. 


* 1, Will DBMS-11 be used {DBM 
For details on DBMS-11, refer to the DBMS-11 documentation. 


This question appears only if the target processor memory is 
greater than 96K, the system is mapped, and you are not generating 
RSX-11S. 


If you select DBMS-11 support, SYSGEN automatically includes 
Executive support for: Asynchronous System Traps (AST support) ; 
Memory management directives; and Send/receive by reference 
directives. See Executive questions 16, 6, and 7 respectively. 


* 2, PILES-11 ACP $ ~ | 


If you do not select Files-11 ACP, none of the services described 


in the LAS/RSX-11 I/0 Operations Reference Manual are generated in 


your system. 


If DBMS-11 is requested (Executive Question 1) this question is 
not asked. 


DEC-supplied software uses the Files-11 ACP; it is recommended 
that you select this option. 


You specify the appropriate FllACP for your application during 
SYSGEN Phase II. 


If you are generating an RSX-11S system, this question is bypassed 
and Files-1l ACP is not included in your system. 


EKIND 


* 3. RMS record locking and placement control 


RMS is the DIGITAL Record Management System. RMS record locking 
and placement control is a feature of the RSX-11M Record 
Management System and is described in the RMS documentation. 


If you selected Files-11 ACP (Executive Question 2) or if it is 
included in your system by default, this question is asked. 
Otherwise, the question is bypassed and RMS-11 is not supported. 
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* 4, Non-resident tasks (task loader) hie 


Non-resident task support allows tasks that are not permanently 
resident in your system to be loaded from disk. 


If you do not include support for the task loader, all tasks must 
be installed and fixed into the system image by VMR. ‘ 


It is highly recommended that you select this option. 


RSX-11S does not support this option; the question does not 
appear. 


* 5. Loadable task loader aad es A 


The RSX-11M task loader reads tasks scheduled for execution from 
disk. Making the task loader loadable is an RSX-11M Executive 
feature that reduces the amount of address space required for the 
Executive (excluding pool), freeing space for additional Executive 
dynamic storage. 


If you answer No to this question, the loader is linked into the 
Executive and requires up to 2400 bytes of Executive virtual 
address space. By making the loader loadable (responding Yes to 
this question), those 2400 bytes become available for use as 
dynamic storage (pool space) or for other Executive features. 


This option is not available on RSX-11S, on unmapped systems, or 
if non-resident task support is not included. 
NOTE 


The loadable loader must be loaded by 
VMR at the end of Phase II. 


* 6. Memory management (PLAS) directives mM mM PR 


Memory management (PLAS) directives provide functions that allow 
tasks to dynamically modify mapping of their physical addresses in 
memory. These directives also allow tasks to dynamically create 
and delete common blocks. 


The following lists the memory management directives: 


ATTACH REGION 

CREATE ADDRESS WINDOW 
CREATE REGION 

DETACH REGION 

ELIMINATE ADDRESS WINDOW 
GET MAPPING CONTEXT 

MAP ADDRESS WINDOW 
RECEIVE BY REFERENCE 
SEND BY REFERENCE 

UNMAP ADDRESS WINDOW 


Memory management directives are restricted to use on mapped 


systems. Therefore, the question is not asked for unmapped 
systems. 


If you selected DBMS-11 (Executive Question 1) memory management 
directives are included by default and this question is not asked. 


a 
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If you select this option, SYSGEN automatically includes support 
for address checking (option 9) and I/O rundown (option 10). 


If you do not select memory management directives, you cannot 
include Executive support for send/receive by reference directives 
(question 7). 


The memory management (or PLAS) directives add approximately 
1000(10) words to the Executive. 


* 7. Send/Receive by reference directives S Ric 


The SEND/RECEIVE by reference directives allow one task to send to 
another task a reference to an area within a region. The receiver 
task is given a specified access which allows it to map to or 
delete the region. 


If you selected DBMS support, SYSGEN automatically includes 
Executive support for the send/receive by reference directives; 
this question is not asked. 


If you did not include support for the memory management 
directives, this question is not asked. 


If you did not select DBMS-11, but included memory management 
directives, this question is asked. 


* 8. Get mapping context directive OM C_ 


This directive returns to the issuing task parameters describing 
the current window-to-region mapping assignments. These 
parameters allow you to restore the mapping context using the 
memory management CREATE ADDRESS WINDOW directive. 


This question appears only if memory management directive support 
was included. 


If you select this feature, Executive support for address checking 
{option 9) and I/O rundown (option 10) are automatically included. 


* 9. Address checking Re K 


This feature directs the Executive to perform boundary checks, 
alignment checks, and modulus checks on addresses passed by users 
in Executive directives. 


Note that if you are generating a mapped system, address checking 
is automatically included; this question is not asked. 


Address checking is recommended unless you are running a 
fully-debugged application system. 


* 10. I/O rundown Tok 


This feature ensures RSX-11M system integrity by cleaning up all 
outstanding task-related I/O before allowing a task to exit. 


It is recommended that you select this feature; I/O rundown is 
recommended unless you are running a fully-debugged application 
system. This feature is automatically included if you are 
generating a mapped system. 
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* 11, Multi-user protection IM eV 


This feature prevents tasks initiated at one terminal from 
interfering with tasks initiated at other terminals. Multi-user 
protection provides for public and private device ownership and 
login and logoff with password protection. 


When you select this feature, SYSGEN automatically includes’ the 
following terminal driver features: 


Read with special terminator 
Breakthrough write 

Read with no echo 

CTRL/R support 


Select multi-user protection support only if your system has 32K 
or more of main memory. 


Multi-user protection support is not available in an RSxX-115 


system; the question 

Multi-user protection 

approximately 100(10) 
* 12. ANSI Magtape ACP 


This feature provides 


is not asked. 


increases the size of the Executive by 
words. 


fr th. 


support for volume and file labels that 


conform to the ANSI standard for industry-compatible tapes. This 
feature requires Executive AST support; if you select ANSI 
magtape ACP support, SYSGEN automatically includes AST support. 


RSX-11S systems do not support ANSI magtapes; 


asked. 


the question is not 


ANSI magtape ACP support increases the size of the Executive by 
approximately 40(10) words. 


Or fe 


* 13. On-line formatting (FMT) or on-line user-mode diagnostics 


On-line formatting or 
Executive and device 


on-line user-mode diagnostics enable the 
drivers to perform special I/O functions and 


return additional device status information required by online 


diagnostic tasks. 


(For information on diagnostic tasks, see the 
RSX-11M/M-PLUS User Mode Diagnostics Manual and the 


RSX-11 


Utilities Manual for online formatter (FMT) information.) 


RSX-11S systems do not support online user mode diagnostics nor 
the FMT task; the question does not appear. 


* 14, Loadable device drivers 


LO 


This feature allows you to load and unload most device drivers 
dynamically using MCR and VMR Load and Unload commands. Only the 
industrial and process control device drivers (UDC, ICS/ICR, 
IP11/IP300, and DRS/DSS) and the VT11/vs60 graphics driver are not 


loadable. 


When you select this 


option, SYSGEN generates loadable device 


drivers; however, SYSGEN makes all data bases resident. 


This question is always asked. 
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The full duplex terminal driver requires loadable device driver 
support. Therefore, if you wish to include the full duplex 
terminal driver, you must include loadable driver support. 


* 15. Should the default for all applicable drivers be loadable LED 


If loadable device driver support is included, this question 
specifies that all drivers (except UDC, ICS/ICR, DRS/DSS, 
IP11/IP300, and VT11/VS60) are to be built as loadable by default 
(you can override the default in the peripheral section). If you 
respond No to this question, all drivers (except the full duplex 
terminal driver, if selected) are built as resident. 


The response to this question sets the default, either L 
(loadable) or R (resident) for responses to peripherals questions. 
You can override the default you set with the response to this 
question in your responses to peripherals questions. 


If loadable device driver support is not requested, all drivers 
will be resident, and this question does not appear. 


* 16. AST and cancel selective MARKTIMES fA oa 


This option allows the processing of Asynchronous System Traps and 
permits you to cancel a single marktime request. 


This feature is automatically included when you select any of the 
following: 


ANSI magtape ACP support 
Floating point processor 

DBMS-11 

LA driver (LPA11-K) 

Console logging driver 

K~series device support routines 


If you exclude this option, the terminal driver cannot support 
unsolicited input character ASTs. 


If you want AST support, but do not need the ability to cancel a 
specific marktime request, enter Yes. You can then edit RSXMC.MAC 
and remove cancel selective mark time support (locate the line 
CSSSMT=0 and delete it). 


* 17. Task termination and device not ready messages (TKTN) | KY 


This feature directs RSX-11M to automatically generate DEVICE NOT 
READY and task termination messages. 


You must select this option if you want Post Mortem Dump (PMD) and 
Snapshot Dump (SNAPS) Support. 


* 18. Power fail recovery $ PEF 


This feature provides for automatic system recovery in the event 
of power failure. Device drivers and tasks that specify a power 
fail AST are notified when power returns. The option is required 
to support powerfail ASTs. 
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* 19, Install, request, and remove on exit S LER 


This feature (the MCR Run command) reduces the number of installed 
tasks in memory, thereby optimizing the use of system memory 
resources and minimizing use of pool. Refer to the description of 


the Run command in the RSX-11M/M-PLUS MCR Operations Manual for 
details of the functions provided by this feature. 


This feature is not available for RSX-11S systems. 


* 20. Large (20K) Executive i 7aKk. 


This feature allows you to generate an Executive larger than 16K 
in order to increase the size of the Executive's virtual address 
space, typically to provide more pool. This reduces to 8K _ the 
maximum size of privileged tasks. 


If you are generating an unmapped system, this question is 
bypassed. 


* 21. Logical device assignment SLED 


This feature (the MCR ASN command) allows you to assign a_ logical 
name to a physical, pseudo, or other logical device. Assignments 
may be made on a per-terminal (local) or system-wide basis 
(global). 


This option comes to you as highly recommended. 


* 22. Logging of device errors and timeouts SPTO 


This feature (Error Logging) causes disk and tape device errors to 
be intercepted and status information describing the error to be 
written to a disk file for analysis. When you select this 
feature, checkpointing and the SEND/RECEIVE directives are 
automatically included in your system. 


RSX-11S systems do not support the error logging subsystem; this 
question does not appear. 

* 23. Logging of undefined interrupts SUant 
This feature directs the Executive to check for traps to undefined 
interrupt vectors and to store information about these traps ina 


disk file for analysis. 


When you select this feature, checkpointing and the SEND/RECEIVE 
directives are automatically included in your system. 


RSX-11S systems do not support the error logging subsystem; this 
question is not asked. 


* 24. Logging of memory parity errors feng 


This feature directs the Executive to log cache and memory parity 
error traps in a disk file for analysis. 


When you select this feature, SYSGEN automatically includes 
non-resident task support, checkpointing support, and _ the 
send/receive directives. 


d 
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This question will only be asked if you specified memory parity 
support. 


RSX-11S systems do not support the error logging subsystem; this 
question is not asked. 


* 25. Do you intend to include a user-written driver IUWD 


User-written drivers can be included in the assembly of the 
Executive. 


If you answer Yes, questions concerning the Executive routines 
SGTWRD (GET WORD) and S$PTWRD (PUTWORD) are asked. You will also 
have the opportunity in SYSGEN Phase II, to add a user-written 
driver to your Executive. 


* 26. Include routine SGTWRD 


This feature (the SGTWRD Executive routine) is used to obtain a 
word from a user-defined buffer. Refer to the RSX-11M Guide To 
Writing an I/O Driver for information on how this routine is used. 


This question is not asked if you do not intend to include a 
user-written driver. 


* 27. Do you require routine SPTWRD 


This feature (the SPTWRD Executive routine) is used to send a word 
to a user-defined buffer. Refer to the RSX-11M Guide To Writing 
an I/O Driver for information on how this routine is used. 


This question is not asked if you do not intend to include a 
user-written driver. 


* 28. Disk writecheck Pusch 


Writecheck support increases the data reliability of disks at the 
cost of a degradation in disk throughput. If selected, writecheck 
may be enabled/disabled dynamically on a per-drive basis via _ the 
MCR Set command. 


Writecheck is supported for all disks except the RX01, RX02, and 
the RLO1. Disks supported are: DB, DF, DK, DM, DP, DR, and DS. 


If you specify writecheck support and issue an MCR Set /WCHK 
command in a running system, the driver performs a read after each 
write. If the data cannot be read or does not match the data 
written, the data is rewritten and another read attempt is 
performed. 


RSX-11S does not support disk writecheck; the question does not 
appear. 
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* 29. Executive Debugging Tool (XDT) Typ 


The Executive Debugging Tool (XDT) provides a subset of ODT-11 
commands to be used in system state. If selected, XDT is included 
in the Executive. This allows interactive debugging of Executive 
modules, privileged tasks, I/O drivers, and interrupt service 
routines. 


This feature includes consistency check code in the dynamic memory 
routines. 


* 30. Rotating pattern in data lights + €OT 


This feature causes the PDP-11 CPU lights to rotate in a 
pronounced circular pattern when the processor is idle. 


This feature functions only on the 11/45, 11/50, 11/55, and 11/70 
PDP-11 processors. This question appears only for the target 
processors listed above. 


* 31. Industrial network or DECnet $NET 


* 


This option allows for the inclusion of DECnet or industrial 
network support. Refer to DECnet documentation for details on 
DECnet; refer to Industrial Products documentation 
(IPL1/IP300/DPM50_ Application Programmer's Manual) for details on 
the industrial network. 
When you select this option, SYSGEN automatically includes: 

e ACP support 

e AST and cancel selective marktime support 

e Logical device assignment support 

e Loadable device driver support 

e Address checking support 

e Get partition parameters directive support 


e Get task parameters directive support 


e Extend task directive support 


32. Queue manager and queued print spooler $PRN 


The queue manager and queued print spooler provide user-controlled 
spooling support for RSX-11M systems. Refer to Appendix D for a 
description of the features of RSX-11M print spoolers. 


If you select this option, the required support is built into the 
Executive. If you respond No, you will be asked in Phase II 
whether or not you want to build the serial despooler. 


This question is asked only for mapped systems. 
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*33. Group global event flags £4 6E 


Group global event flags provide each group (in the 


uric 


specification [group,member]) of system users with 32 (decimal) 
additional event flags. For more information on group. global 


event flags, refer to the RSX-11M/M-PLUS MCR Operations Manual. 


* 34. Enter code for directives $D RK 


Use this option to include system directives, as indicated by 
associated letter in the table below. 


Enter * to display table of directives. 
Enter % to include all directives. 
Enter . to terminate the question. 


For descriptions of the directives listed below refer to 
RSX-11M/M-PLUS Executive Reference Manual. 


A- Get partition parms B- Get task parameters 


C~ Send/Receive D- Alter priority 
E- Extend task F- Connect to interrupt vector 
G- Get sense switch H- Stop bit 


the 


the 


If you do not select get partition parameters (option A) and get 
task parameters (option B), the MCR ASN, ATL, DEV, PAR, TAL, and 


TAS commands will not execute correctly. 


If you select DBMS-11 or DECnet support, SYSGEN automatically 
includes Stop Bit, Get Partition Parameters, and Get Task 
Parameters support. Also, the extend task directive is included 


by default. 


If you select ANSI magtape support and error logging support 


for 


device timeouts and parity errors, SYSGEN automatically includes 


Send/Receive support. 


If you select loadable driver support, Connect To Interrupt Vector 


support is included. 


If you select K-series devices, Connect To Interrupt Vector 


support is included, 


If the target processor does not have a switch register, SYSGEN 


does not allow the inclusion of the Get Sense Switch directive. 


* 35. Number of pre-allocated QIO packets [0:15.:5.] = iV PK 


I/O throughput is enhanced by pre-allocating a number of 


I/o 


packets from the dynamic storage region, leaving them available 


for quick use by Queue I/O. 


The Executive maintains a Last In First Out (LIFO) list 


of 


preallocated I/0 packets; you specify the maximum size of this 


list with your response to this question. When any I/O packet 


is 


required, the Executive removes one from this list. If the list 
is empty, the Executive allocates the packet from dynamic memory; 


a Significantly slower operation. When any I/0 packet 
deallocated, the packet is linked into the list, provided that 
list is not full. 


is 
the 
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Thus, in each I/O request, two fast LIFO operations replace the 
slower general pool allocations and deallocations, saving several 
hundred microseconds. Some I/O requests involving an ACP require 
two I/O packets and, therefore benefit twice as much. 


Each I/O packet you preallocate requires 18 words from pool. To 
determine the number of I/O packets to preallocate, consider the 
normal fluctuation in the total number of I/O requests. The 
fluctuating total number is always smaller than the number of 
outstanding I/O requests. 


Enter a number in the range 0. to 15., indicating the number of 
packets to be pre-allocated. 


The default is 5. 


Enter 0 to exclude pre~-allocated QIO packets. 


* 36. Size of data transfer vector in words rer ik) 


An additional speed improvement is achieved by optimizing data 
transfers in the Executive module BLXIO. One improvement is the 
use of a series of MOV instructions which is used to save time on 
loop control. This is called the data transfer vector. 


Enter a number in the range 5. to 33., to specify the number of 
MOV instructions in the vector. If you enter a value of 16, for 
example, a 36-word data transfer enters the loop control three 
times as opposed to 36 times if there were only one MOV 
instruction in the vector. 


The default is 33. 


This question does not appear for unmapped systems. 


ds j 
* 37. Round-robin scheduling interval in ticks foaveeathy © 


When many competing memory-resident tasks have equal priority, the 
Executive tends to give CPU time more frequently to tasks that 
appear first in the Active Task List (ATL). Entries in the ATL 
with equal priority normally appear in the order in which the 
tasks were installed. 


To avoid this problem, RSX-11M provides the round-robin scheduling 
option. This Executive scheduling algorithm periodically rotates 
(when the specified number of ticks elapses) tasks of equal 
priority within the Active Task List, ensuring that tasks of equal 
priority share CPU time. The overall effect is to evenly 
distribute the use of CPU time, giving each task of equal priority 
time at the head of the Active Task List. 


Round-robin scheduling refers to the algorithm whereby each task 
of a group of tasks is successively given preference when 
allocating available processor time. The actual algorithm used in 
RSX-11M is to locate the first task within each priority class 
that is not blocked from executing, give it a slice of processor 
time, and when it completes, move that task to the end of its 
respective priority class. Compute-bound tasks tend to actually 
round-robin, whereas I/0O~-bound tasks tend to remain at the front 
of their respective priority class. 
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Round-robin scheduling does not affect the normal competition for 
CPU time of tasks with different priorities. It also does not 
affect tasks not in the range set by the response to SYSGEN Phase 
I Executive questions 38 and 39. 


Round-robin scheduling affects only those tasks in an ATL (in 
memory) that are neither blocked nor in the waitfor state. 


Tasks that are checkpointed or in a partition wait queue are not 
affected. 


Round-robin scheduling costs little in terms of Executive overhead 
(time and size). 


If you do not want this option, enter 0. 


If you want this option, enter a number in the range 1. through 
1000. SYSGEN then asks questions 38 and 39. 


The default is 5. 


* 38. Highest priority class for consideration [1.:249.:150.] ¢ 


Round robin scheduling executes for a specified range of priority 


classes. A typical range is 1. to 150. Permissible range is l. 
to 249, | 


This entry is the highest priority class eligible for round robin 
scheduling. Default is 150. 


This question appears only if you selected the round robin 
scheduling option. 


es 


* 39. Lowest priority class for consideration [l.:high.:1] +} 


This is the lowest priority class eligible for round robin 
scheduling. 


Range is 1. to (highest priority class entered in response to 
question 38). 


Default is l. 


This question appears only if you selected the round robin 
scheduling option. 


* 40. Executive level disk swapping interval [0:5000.:low.:] ¢ DA =. 


Disk swapping is an Executive feature that varies the priority of 
memory resident tasks with the same priority so that those tasks 
can share the use of memory resources. The feature swaps tasks to 
disk based on the swapping algorithm. 


The swapping algorithm creates an "effective" task priority using 
the swapping interval (the response to this question) and the 
swapping priority (the response to question 41). The swapping 
interval specifies a time parameter, in which the Executive scans 
the partition list and modifies the effective priority of a 
resident task. The swapping priority is an absolute numeric value 
that specifies the range through which a task varies its priority. 
(The range is negative swapping priority through positive swapping 
priority.) 
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The Executive uses a byte in the task header to maintain the 
swapping priority; symbol SS$S$WPR in RSXMC.MAC. ‘The symbol SSSWPR 
is equated to the swapping priority specified in question 41. 


Each time a task is read into memory, the Executive initializes 
the swapping priority in the task header to the value +SSSWPR (for 
example, +5 if you specify 5 as the swapping priority in question 
41). Then, when the swapping interval expires, the Executive 
decrements the swapping priority of each memory-resident task by 
one until the task is checkpointed or until the swapping priority 
reaches the minimum value -SSSWPR (for example, -5). 


After decrementing the swapping priority of each task in the 
partition, the Executive determines whether or not an eligible 
task on disk can checkpoint a task in the partition. The 

| Executive compares the running priority of the non-resident task 

with the effective priority of the resident task (effective 

| priority is the sum of the running priority and the swapping 
priority). If the non-resident task can fit in the resident 
task's space and if, due to the decrementing of swapping priority, 
the priority of the non-resident task is higher, the non-resident 
task can checkpoint the resident task. 


This procedure executes for tasks competing for each main 
partition (except DEVICE and COMMON partitions) and for the 
highest priority, non-resident task assigned to each partition. 


If you select this option, SYSGEN automatically includes support 
for checkpointing. 


The permissible range is 0 to 5000. The default is a value that 
is equal to the round robin scheduling interval multiplied by 6. 
If the round robin scheduling interval was 0 (you excluded 
support), this default is 30. 


To disable this option, enter 0. 


* 41, Swapping priority (1:20.:5] ¢ 


The swapping priority determines the range over which lower 
priority tasks may checkpoint higher ones; the larger’ the 
swapping priority, the greater the range. With a swapping 
priority of "S", a task running at priority "P" will have an 
effective priority range (for checkpointing) from "P+S" to “p-s" 
as long as it resides in memory. 


Enter a number in the range 1 to 20. It is recommended that you 
enter the default swapping priority of 5. 


This question is asked only if Executive level disk swapping was 
i requested. 

| * 42, Size of dynamic storage region in words [256.:16384.:1024.] {DSA 
RSX-11M uses the dynamic storage region (pool) to perform many 


functions. For example, the Executive uses this memory space to 
process I/O or time-dependent scheduling requests. 
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Rather than allocate a fixed amount of memory for each function, 
the RSX-11M Executive makes use of a dynamically allocated memory 
space called the dynamic storage region (DSR). As demands’ for 
Space are made, the necessary memory is allocated from this region 
using a first-fit algorithm. When allocated space is no _ longer 
needed, it is released back to the pool of available memory. 


Dynamic memory requirements for a system depend on the 
configuration, application, and degree of system loading. Enough 
Memory muSt be available to satisfy peak demands; otherwise a 
degradation in system performance will occur and the system could 
hang with a DSR deadlock. 


On the other hand, if too much memory is made available, it is 
never used and is thus wasteful of system resources. 


The maximum size of the dynamic. storage region is limited by 
physical memory in an unmapped system. In a mapped system, the 
total size of the Executive, resident drivers, and the dynamic 
storage region must not exceed 16K if you responded No to question 
20 or not exceed 20K if you responded Yes to question 20. 


NOTE 


In a mapped system, the automatic VMR 
process attempts to allocate as much 
pool as possible (up to the maximum 
Executive size). If you do not edit the 
command file (SYSVMR.CMD) that performs 
this, the response to this question is 
not critical. 


The following list specifies some RSX-11M functions that use 
dynamic memory. Use this list to calculate how much memory you 
should allocate. 


Tasks; Each task installed in the system requires at least 20 
words for a task control block. 


I/O Requests: Each 1/0 request results in the allocation of an 
18-word I/O packet, which is queued to the appropriate device 
driver. 


SEND DATA and SEND BY REFERENCE Message: Each Send Data or Send 
by Reference message sent to a task results in an 18-word 
message packet being allocated to hold the requisite data. 


Partitions and Subpartitions: Each main partition and 
subpartition requires a partition control block of at least 14 
words to describe its memory. In addition, for each active 
task, fixed task, and loaded driver ina system-controlled 
partition, (whether the tasks are checkpointed or in memory) a 
PCB is built and allocated in the dynamic storage region. 
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Open Files: Each open file requires 18 words for a file control 
block and 18 words for a window block which contains 
virtual-to-logical block mapping pointers. 


The file system ACP (F11ACP) may be built to store File 
Control blocks in its own task image rather than in dynamic 
storage region. (See details of SYSGEN Phase II.) The more 
space allocated at task build time, the less the demand will 
be on the pool. However, if the allocated space becomes used 
up, the overflow will use the dynamic storage region. 


Mounted Volumes: Each mounted volume requires 18 words for a 
volume control: block, 18 words for the index file window 
block, and 18 words for the index file control block. In 
addition, three 18-word control blocks are required to hold 
information pertaining to the last three directory files that 
were accessed. For systems that contain I/O optimization, MOU 
will try to allocate a window block for the index file of 
sufficient size to contain all of the retrieval pointers. 
This could require up to 208 words. If the space is not 
available, MOU will default to 18 words. Space-saving hint: 
The directory least-recently-used (LRU) table default is three 
18-word file control blocks. The effect of this table is a 
significant increase in the speed of directory operations. If 
this level of performance is not required, a volume may be 
mounted using the /LRU keyword, thereby reducing the number of 
FCBs used. 


Clock Queue Entries: Each clock queue entry requires eight words. 
These entities represent mark time, schedule, and periodic 
scheduling requests. 


AST-Related Processing: Each powerfail, receive, and floating 
point processor AST trap-enable for active tasks requires 
eight words for an AST control block. 


I/O Buffers: All terminal output is buffered in the terminal 
driver before transferring information to the user buffer. 
Each solicited and unsolicited input request requires a 
42-word input buffer. 


Card Images: Card images read from the CM/CRl11 are buffered by 
the card reader driver before transferring the translated 
information to the user buffer. Binary output requires an 
80-word buffer, whereas ASCII input requires a 4-word buffer. 


LPS11 and AR11 Synchronous Functions: Each LPS11/AR11 synchronous 
function requires 20 words for a sample control block. 


Task Headers: In a mapped system, the task header is copied into 
a block of memory allocated from the dynamic storage region. 
Approximately 64 words (dependent upon the number of LUNS~ and 
window blocks) are required for each task that is in memory 
(i.e, in execution and not checkpointed, or inactive and 
fixed). 


Task Linked to ICS/ICR-1l1 Interrupts: Each task linked to 
ICS/ICR-11 interrupts requires 16 words of dynamic memory, 
plus six words for each interrupt linkage. 


Data Bases for Loadable Drivers: Data bases that are loaded into 
a system with a loadable driver require space equal to the 
size of the data base. 
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Loadable Drivers: Loaded drivers on a mapped system require space 
for interrupt linkage as follows: 


@e 14 words per interrupt entry for single-controller, 
non-error-logging drivers 


@e 22 words per interrupt entry for multi-controller, 
non-error-logging drivers 


e 14 words for the first (or only) interrupt entry for 
error-logging drivers, plus 6 words for each additional 
interrupt entry for error-logging drivers 


Checkpointing: Systems with dynamic checkpoint space allocation 
require 8 words to describe each checkpoint file and 8 words 
for each task checkpointed to a checkpoint file, 


Memory Management Directives: Systems supporting the memory 
Management directives require 6 words per task (active or 
fixed) for each region a task is attached to. This includes 
the task region and all static and dynamic commons. 


Connect to Interrupt: Systems supporting the connect to interrupt 
directive require 22 words for each Interrupt Transfer Block 
(ITB) used for each interrupt vector serviced by a 
connect-to-interrupt directive. 


Error Logging: Variable-length packets are allocated for each 
logged error which has not been serviced by the error logger. 


(See the RSX-11M/M-PLUS Error Logging Reference Manual.) 


After you calculate the size of the DSR, add approximately 12-18 
percent to cover possible pool fragmentation conditions. 


‘Note that you can later extend this initial allocation using the 
MCR Set /POOL command. 


This entry must be in multiples of two words. The permissible 
range of entries is 256. to 16384. 


The default is 1024. 


* 43. Seconds between printer not ready messages [0:255.:30.]4 PNIR 


This question is asked if a line printer was specified in the 
peripheral configuration and you included TKTN support (the TKTN 
task prints the message). 


Specify the number of seconds between printer not ready messages. 
An entry of 0 suppresses the messages altogether. 


The default is 30. If you make a non-zero entry, the minimum 
value of this entry is 15. 

* 44. Seconds between card reader not ready messages [(0:255.:30.] 
This question is asked if a card reader was specified in the 
peripheral configuration and you included TKTN support (the TKTN 


task prints the message). 


Specify the number of seconds between card reader not’ ready 
messages, An entry of zero suppresses the messages altogether. 
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The default is 15. 


If you enter a non-zero value, the minimum value of the entry is 


15. 
* 45. System crash register and stack dump device CSR 
[0:177700:177564] KSD 


If the system crashes and this option is included, the Executive 
stack and registers are dumped to the selected device. 


Enter the CSR address of the device. The normal device is the 
console terminal, which has a CSR address of 177564. This is the 
default device. 


Enter 0 to suppress this option. 


If you enter a non-zero value, it must be in the range 160000 to 
177700. 


* 46. Checkpointing: A- Yes B- With system checkpoint file Ie 


Checkpointing allows the Executive to displace tasks from a 
partition to yield memory to tasks of higher priority. 


The goal of checkpointing is to avoid preempting the execution of 
lower-priority tasks unless a higher-priority task can make use of 
the memory resources allocated to the lower-priority task. This 
optimizes the use of processor memory while maintaining a priority 
scheduling algorithm. 


In some cases, an activated task cannot execute because the 
partition in which the task must execute is occupied. 


If the partition is occupied by a task (TASKA, for example) that 
is both checkpointable and has a priority lower than the task that 
is waiting (TASKB, for example), the Executive may move the task 
with the lower priority (TASKA) to disk, thus making room for the 
higher priority task (TASKB) waiting on disk. 


When the higher priority task (TASKB) is stopped or allows its 
priority to be lowered, the lower priority task (TASKA) on disk 
may be moved back into memory to continue execution. 


This task (TASKA) continues execution from the point at which it 
was interrupted. 


RSX-11M supports checkpointing in both user-controlled partitions 
and system-controlled partitions. 


Enter A if you want checkpointing. (SYSGEN automatically includes 
checkpointing if you selected Executive level disk swapping.) 


Enter B if you want checkpointing with a system checkpoint file. 
Selection of this (B) option allows checkpointing into a system 
checkpoint file rather than requiring space in each checkpointable 
task image. 


Enter carriage return to exclude this feature. 
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If you select checkpointing with a system checkpoint file (B), you 
must allocate space for the file when you start up the system, for 
example, in STARTUP.CMD. Refer to the RSX-11M/M-PLUS MCR 
Operations Manual for more information. 


Note that if you exclude checkpointing support, the terminal 
driver cannot support task checkpointing during terminal input. 


This option does not apply to RSX-11S systems; the question is 
omitted. 


* 47, System-controlled partitions: A-Yes B-Yes With auto compaction 
(SHF) 


This option allows as many tasks as will fit into a partition to 
be simultaneously resident. The allocation of partition memory is 
automatic and is carried out by the RSX-11M Executive dynamically. 


Enter A if you want system-controlled partitions. 


Enter B if you want system-controlled partitions with automatic 
compaction (the Shuffler task). 


When the Executive determines that there is insufficient memory to 
load a waiting task into a system-controlled partition, the 
shuffler executes (following an allocation failure during an 
attempt to allocate memory from a system-controlled partition). 


The shuffler scans Partition Control Blocks searching for a 
system-controlled partition which has at least one eligible task 
waiting for memory. When such a partition is found, the shuffler. 
attempts to compact the memory partition and thus form a 
contiguous space large enough to contain the waiting task. 


The shuffler algorithm consists of two passes through each 
system-controlled partition. 


In the first pass, the shuffler unconditionally checkpoints all 
stopped, checkpointable tasks. (This includes all tasks stopped 
for terminal input if you select option 5 in the terminal driver 
section of Phase 1.) The shuffler then starts at the beginning of 
the system-controlled partition and tries to move (shuffle) all 
tasks that are positioned above a gap of free space down to the 
base of the free space. When the shuffler completes its first 
pass, all stopped, checkpointable tasks are checkpointed and all 
free space in the system-controlled partition has been merged into 
one hole at the top of the partition. (However, there may be 
additional holes below these tasks that cannot be shuffled.) 


If the shuffler completes its first pass and some eligible tasks 
are still waiting for space in the partition, the shuffler 
executes its second pass. In the second pass, the shuffler 
creates an ascending, priority-ordered list of the tasks in the 
partition. It then uses this list to determine if the size of the 
waiting task is less than the sum of the free space and the size 
of one or more of the lower priority, checkpointable tasks. If, 
and only if, the size of the waiting task is less than this sum, 
the lower priority tasks are checkpointed. 


Unmapped systems do not support system-controlled partitions. 
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If you select DBMS-11, this feature (A) is included by default. 


However, the shuffler (B) is not; if you want the shuffler, you 
must select it, 


This option does not apply to RSX-11S systems; SYSGEN omits the 
question. 


* 48, Dump Analysis: A~ PANIC B- Crash (CDA) q | 


If the dump routine option is omitted and a system failure occurs, 
it may not be possible for the user to capture vital data on the 
state of the system at failure time. The RSX-11M Guide to Writing 
an_I/O Driver describes the PANIC dump routine. The CDA crash 
dump routine is normally used in debugging new drivers or 
privileged tasks after the drivers or tasks crash the system. It 
provides a means of generating a formatted dump of memory on a 
line printer or a terminal. For more detailed information, refer 
to the RSX-11M/M-PLUS Crash Dump Analyzer Reference Manual. 


Enter A if you want the panic dump routine 
Enter B if you want crash dump analysis (CDA) support 
If you select B, SYSGEN asks Executive Questions 49, 50, 51, and 
52. 

* 49. Output notification device CSR [160000:177700:177564] Vay 
This question appears if you selected B (crash dump support). 


Enter the CSR of the device to which the crash notification is to 
be output. Typically, this will be the console device (177564). 


* 50. Memory dump device (ddu:) [3:4] ANA, 


This question appears only if crash dump analysis (CDA) support 
was selected. 


Enter the mnemonic and unit number of the device on which you want 
a memory dump. Note that the memory dump device must be part of 
the target hardware configuration, but not necessarily generated 
into the target system. Supported devices are DT, DK, MT, MS, MM, 
DB, DM, DL, DD, and DR. 


Avoid, if possible, using your system device as the crash dump 
device. 
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* 51. CSR address of dump device [160000:177700:default] 


Enter the CSR address of the dump device. The default depends on 
the type of device you specify as the crash dump device: 


Device Default 
Type CSR 
DT 177342 
DK 177404 
MT 172522 
MM 172440 
DB 176700 
DL 174400 
DM 177440 
DR 176700 
DD 175600 ; 
MS 172522 


* 52. CSR address of PANIC dump device [160000:17700:177564] 


If panic dump was selected, enter the CSR address of the indicated 
panic dump device. Normally, this is the CSR address of the 
console device, which is also the default. 


This device must be a paper tape, terminal, or line 
printer-compatible device. The device must receive a single byte 
at a time. 


This question is asked only when you request panic dump support 
(option A in Executive Question 48). 


5.5 TERMINAL DRIVER QUESTIONS 

This section allows you to choose which of the RSX-11M terminal 
drivers you want as part of your system. The section also allows you 
to specify terminal driver options. 


Terminal driver options are described fully in the RSX-11M/M-PLUS 1/0 
Drivers Reference Manual. 


Answer Yes to the options you want included in your system. 


* 1, Terminal driver desired (A/B/C/D, * prints table) 


This question allows you to select the terminal driver you want to 
include in your system. RSX-11M systems use one of two terminal 
drivers: 


e Half duplex (baseline, no options; tailorable, you select 
options; and tailored, user-oriented options included by 
default) 

e Full duplex 


Enter A to select the half duplex terminal driver that you tailor 
(specify specific options) to meet the needs of your system. 
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Enter B to select the user-oriented half duplex terminal driver. 
The user-oriented driver includes the following options: 

e Automatic carriage return/line feed (option 4) 

e Task checkpointable during terminal input (option 5). Note 
that if you did not include Executive support for 
checkpointing, this option is excluded when you select the 
user-oriented terminal driver. 

@ Unsolicited input character AST (option 6). Note that this 
option requires Executive AST support. Therefore, if you did 
not include Executive AST support, this option is excluded 
when you select the user-oriented terminal driver. 

e Write with CTRL/O cancellation (option 7) 

e Breakthrough write (option 8) 

e cCTRL/R retype (option 9) 

e Get multiple characteristics (option 11) 

e Get terminal driver options (option 13) 

® Transparent read/write (option 15) 

e Settable case conversion for input (option 16) 

e Read after prompt (option 17) 

e Read with no echo (option 18) 

e Read with special terminator (option 19) 

@e CRT rubout support (option 20) 

@ Terminal-host synchronization (option 21) 

e Variable length terminal input buffering (option 23) 

If you want more or fewer options with the half duplex terminal 
driver, you should select the tailorable half duplex terminal 
driver (enter A). 

Enter C to select the full duplex terminal driver. This driver 
requires a mapped system and loadable driver support. The full 
duplex driver includes the following options: 

e Passes form feeds directly to the terminal (option 3) 

@ Automatic carriage return/line feed (option 4) ; 

@e Task checkpointable during terminal input (option 5). Note 
that this option requires Executive support for checkpointing. 
Therefore, if you did not include checkpointing support, this 
option is excluded when you select the full duplex terminal 
driver. 

e Unsolicited input character AST (option 6). Note that this 
option requires Executive AST support. Therefore, if you did 


not include Executive AST support, this option is excluded 
from the full duplex driver. 
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e Write with CTRL/O cancellation (option 7) 


e Hold screen mode (option 14) 


@® Transparent read/write (option 15) 


e Settable case conversion for input (option 16) 


e@e Read with no echo (option 18) 


e Read with special terminator (option 19) 


e Terminal-host synchronization (option 21) 


e User terminal input buffering (option 22) 


@ Variable length terminal input buffering (option 23) 


e LA30P support (option 24) 


e Hardware unrecoverable input error support (option 25) 


e Device independent cursor positioning (option 26) 


Enter D to select the baseline terminal driver. 


driver 


Note that 
and a multiuser protection system are mutually exclusive. 
The baseline driver is a minimum half duplex terminal driver 
no SYSGEN options. 


* 2. Unsolicited input timeout value in seconds 7M Nv 


This option is available with the full duplex ter 
only; the question does not appear if you responded A, B, or D to 
question l. 


The full duplex driver discards unsolicited 


expiration of the timeout value that you specify. 
range is 0 to 2540 seconds. 


Enter 0 


to inhibit the full duplex terminal 


input timeout feature. 


driver 


Enter carriage return (the default timeout: value is 
or specify the number of seconds (in the range 1 to 2540) to wait 
to timeout on unsolicited terminal input. 


* 3. Pass form feeds directly to the terminal 


This question appears only if you responded A or B to 
(selected the tailorable or pre-tailored half duplex terminal 


driver). 


this 


with 


Minal driver 


input upon 


the 


Valid timeout 


unsolicited 


120 seconds) 


question 1 


The half duplex driver normally converts a form feed into 8 


feeds. 


Enter Yes to suppress this conversion. 


line 


Ai TT ES SAD A nnn 
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NOTE 


If your system includes an LA120 or an 
LA180S terminal, you must respond Yes to 
this question and include the option. 


This option adds approximately 24(10) words to the terminal 
driver. 


* 4. Automatic carriage return/line feed 


This question appears only if you responded A to question 1 
(selected the tailorable half duplex terminal driver); the 
user-oriented driver and the full duplex driver include the option 
by default. 


If you respond Yes to this option (or if the option is included by 
default), the terminal driver generates a carriage return and line 
feed when the terminal buffer is filled on output or echo. (You 
can examine or alter terminal buffer size with the MCR Set /BUF 
command.) This option adds approximately 70(10) words to the 
terminal driver. 


* 5. Task checkpointable during terminal input 


This question is omitted if you responded with C to question 1; 
the full duplex driver includes the option automatically. Also, 
since a response of B to question 1 selects a pre-tailored half 
duplex driver, this question does not appear. 


The question appears only if your response to question 1 was A and 
you included Executive support for checkpointing. 


If you select this option, checkpointable tasks can be displaced 
from memory during terminal input by another task. This option 
adds approximately 110(10) words to the terminal driver. 


NOTE 


This option can only be included in 
systems that contain Executive support 
for checkpointable tasks. 


* 6. Unsolicited input character AST 


This question appears only if you responded A to question 1 and 
included Executive support for ASTs; when possible, the 
user-oriented and full duplex drivers include the option by 
default. 


If you select this option, a task that attaches to a terminal can 
specify an AST entry point upon receiving unsolicited input from a 
terminal (for example, CTRL/C gains the task's attention rather 
than MCR). This option adds approximately 160(10) words to the 
full duplex terminal driver and approximately ee) words to the 
half duplex terminal driver. 
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NOTE 


This option requires Executive AST 
support. 


* 7. Write with CTRL/O cancellation 


This question appears only if you responded A to question l. 


If you select this option, a task that issues a write request with 
CTRL/O cancellation can print to the terminal when the target 
terminal has suppressed output with CTRL/O. This option adds 


approximately 16(10) words to the terminal driver. 


* 8. Breakthrough write 


This question appears if you responded A or C to question 1. 


If 


you selected multiuser protection support, SYSGEN automatically 


includes this option. 


If you select this option, a privileged task that issues 


a 


breakthrough write request can print to a terminal regardless of 
current or outstanding I/O activity. This option adds 
approximately 96(10) words to the full duplex terminal driver and 


approximately 245(10) words to the half duplex terminal driver. 


NOTE 


When you select this option, SYSGEN 
automatically includes terminal driver 
support for the CTRL/R retype option 
(option 9). Together, these two options 
add approximately 160(10) words to _ the 
full duplex terminal driver and 
approximately 275(10) words to the half 
duplex terminal driver. 


* 9, CTRL/R retype 


This question appears if you responded A or C to question 1 
did not select the breakthrough write option (option 8). 


and 


If you select this option, the terminal driver sends a carriage 
return/line feed followed by the contents of the input buffer 
whenever you type CTRL/R at the terminal. This option adds 
approximately 64(10) words to the full duplex terminal driver and 


approximately 32(10) words to the half duplex terminal driver. 


ee 
* 10. Escape sequence handling ee 5 SC 
This question appears if you responded A or C to question 1. 


If you select this option, the terminal driver recognizes 


and 


treats escape sequences as line terminators for all solicited 
input except read-pass-all or read-with-special-terminator 
requests. This option adds approximately 128(10) words to the 
full duplex terminal driver and approximately 160(10) words to the 


half duplex terminal driver. 
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* 11. Get multiple characteristics [V\ ) Ca 


This question appears if you responded A or C to question l. 


If you select this option, a task can determine physical 
characteristics (for example, CRT, VT52, slaved, or VT100) of 
individual terminals. The task RMDEMO makes use of this option, 
for example. This option adds approximately 96(10) words to the 
full duplex terminal driver and approximately 110(10) words to the 
half duplex terminal driver. 


4 
* 12. Set multiple characteristics Lg ff. ti? 
This question appears if you responded A or C to question l. 


I£ you select this option, a task can set or reset physical 
characteristics (for example, CRT, VT52, slaved, or VT100) of its 
TI: terminal. A privileged task can use this option to set 
physical characteristics of any terminal in the system. This 
option adds approximately 256(10) words to the terminal driver. 


* 13, Get terminal driver options a i a y 
This question appears if you responded A or C to question l. 


If you select this option, a task can determine which of the 
terminal driver options were selected during system generation. 
This option adds approximately 32(10) words to the full duplex 
terminal driver and approximately 64(10) words to the half duplex 
terminal driver. 


* 14. Hold screen mode 
This question appears only if you responded A to question 1. 


If you select this option and your terminal(s) include special 
hardware, the terminals can break stream output into pages that 


fit on the screen. (Note that an unsolicited CTRL/C disables hold 
screen mode.) 


NOTE 


When you select this option, SYSGEN 
automatically includes terminal driver 
support for the transparent read/write 
option (option 15). 


This option adds approximately 92(10) words to the terminal 
driver. 


* 15. Transparent read/write 


This question appears only if you responded A to question 1 and 
did not include the hold screen option (option 14). 


The terminal driver normally filters terminal input on both input 
and output. This permits the recognition of control characters 
that have special meaning (for example, escape) or require fill 
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characters (for example, carriage return). If you select this 
option, the terminal driver provides support for I/O functions 
(IO.RAL and IO.WAL) that bypass character filtering and permits 
output of to 32K bytes. This option adds approximately 48(10) 
words to the terminal driver. 


* 16. Settable case conversion for input 
This question appears only if you responded A to question l. 


The terminal driver normally accepts and echoes characters as 
received. If you select this option, you can selectively enable 
(using the MCR Set /LOWER command) so that the driver 
automatically converts lower case input to upper case. This 
option also allows the terminal driver to recognize the brace 
character (175) and the tilde character (176) as ASCII characters 
rather than a form of escape when the terminal is set to lower 
case. This option adds approximately 30(10) words to the terminal 
driver. 


* 17. Read after prompt RAP 
This question appears if you responded A or C to question l. 


If you select this option, a read after prompt request acts like a 
write to the terminal followed by a read. This reduces the 
overhead of one I/O request and eliminates context switching. 
Also, this option removes the execution window, provided the 
terminal is not attached, by which one task can prompt and another 
task initiate terminal I/0 before the first task (the prompting 
task) had time to issue its read request. This option adds 
approximately 128(10) words to the full duplex terminal driver and 
approximately 185(10) words to the half duplex terminal driver. 


* 18. Read with no echo 


This question appears only if you responded A to question 1 and 


did not include multi-user protection support. (Multi-user 
protection support automatically includes this terminal driver 
option.) 


If you select this option, you can issue the read functions 
IO.RLB, IO.RVB, and IO.RPR and specify that the driver not echo 
terminal input. This option adds approximately 48(10) words to 
the terminal driver. 


* 19. Read with special terminator 


This question appears only if you responded A to question 1 and 


did not include multi-user protection support. (Multi-user 
protection support automatically includes this terminal driver 
option.) 


The line terminators for a normal read are carriage return or 
escape. If you select this option, any character less than 40 
octal or greater than 174 octal can terminate a read with special 
terminator request. However, escape sequences cannot be 
recognized in this mode. Also, note that if the terminal is set 
to lower case, only 177 octal and characters less than 40 octal 
can act as terminators. This option adds approximately 45(10) 
words to the terminal driver. 
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fue 
* 20. CRT rubout support C15 


This question appears if you responded A or C to question l. 


If you select this option, the terminal driver echoes rubouts or 
deletes on a CRT terminal as backspace-space~backspace; 
effectively, this option erases the character from the CRT screen 
when you type rubout or delete. This option adds approximately 
64(10) words to the terminal driver. 


* 21. Terminal-host synchronization 
This question appears if you responded A to question 1. 


If you select this option, you can start and stop terminal output 
by typing CTRL/S (to stop) and CTRL/Q (to start). This option is 
useful for high speed display terminals. 


NOTE 


If your system includes a VT50 terminal 
with the copier option, you must respond 
Yes to this question and include the 
option, 


This option adds approximately 84(10) words to the terminal 
driver. 


* 22. User terminal input buffering 


This question appears only if you responded A to question 1. 


The terminal driver normally receives characters and stores the 
characters in the Executive address space until receiving a line 
terminator. Upon receiving a line terminator, the driver copies 
the contents of the buffer into the requesting task's input 
buffer. If you select this option, the driver, provided that the 
task is not checkpointable, places the input characters directly 
into the task buffer as the characters are received. This option 
adds approximately 12(10) words to the terminal driver. 


* 23. Variable length terminal input buffering 
This question appears only if you responded A to question l. 


Normally, terminal driver input buffers are 80 bytes long, which 
implicitly limits the maximum size of a terminal input request as 
well as the size of the minimum buffer allocation from dynamic 
memory. If you select this option, the terminal allocates buffers 
large enough to satisfy the read request. The largest buffer can 


be 255 bytes long. This option adds approximately 24(10) words to 
the terminal driver. 
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* 24, LA30P support 


This question appears only if you responded A to question l. 


The LA30P DECwriter connects to the processor via a_ single 
buffered interface. If you do not select this option, the second 
of two rapidly typed characters may be discarded by the terminal 
driver. 


NOTE 


Choose this option only if your system 
includes an LA30P terminal; the 
terminal driver properly supports all 
other combinations of DEC terminals and 
interfaces. 


This option adds approximately 48(10) words to the terminal 
driver. 


* 25. Hardware unrecoverable input error notification HK = 
This question appears only if you responded C to question 1. 


If you select this option, the full duplex terminal driver detects 
and flags framing errors, character parity errors, and data 
overruns and then passes the input character(s) to the requesting 
task with notification (including type) of an input error. If you 
do not select this option, the driver discards hard receive 
errors. This option adds approximately 32(10) words to the 
terminal driver. 


* 26. Device independent cursor positioning Vi GZ 
This question appears only if you responded C to question l. 


If you select this option, the full duplex terminal driver 
supports terminal independent cursor positioning commands. When 
you specify a cursor positioning character, the driver outputs a 
cursor positioning character string before it outputs the buffer. 
This option adds approximately 192(10) words to the terminal 
driver. 


5.6 PERIPHERAL QUESTIONS 


This section of questions describe the peripheral devices included in 
your target configuration. The questions define unique hardware and 
software information that RSX-11M uses to communicate with peripheral 
devices. SYSGEN generates questions only for those devices you 
specified in response to target configuration question 16. 


During this section, you enter device-dependent parameters which 
define addressing information as well as special attributes for the 
peripheral devices. SYSGEN displays a prompt line that describes the 
required parameters and then a specific device question, which 
includes any default values for the parameters. 
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If you selected loadable driver support, the general form of a SYSGEN 
prompt is: 


Enter [L/R,] parameterl, parameter2,...parametern for: 


where: 


L/R is an optional parameter that specifies whether the 
driver is loadable (L) or resident. Note that you 
specified the default value for this parameter in your 
response to Executive question 15. If your response to 
question 15 was No, all drivers are resident unless you 
override the default by specifying L. Likewise, if 
your response to question 15 was Yes, all drivers are 
loadable unless you override the default by specifying 
R. 


The process control drivers (UDC, ICS/ICR, IP11/IP300 
and DRS/DSS drivers) and the VT11/VS60 graphics driver 
are not loadable; this parameter does not appear. for 
these drivers since they are always resident. 


The full duplex terminal driver is always loadable; 
this parameter does not appear for the full duplex 
terminal driver. 


If you override the default (specify an L or an R), you 
must terminate this parameter with a comma (,), even if 
it is the only parameter on the line. 


parameter is a device dependent parameter (parameters 1 through 
n). 


If you did not select loadable driver support, the general form of a 
SYSGEN prompt is; 


Enter parameterl, parameter2,...parametern for: 
where parameters 1, 2, through n are device dependent parameters. 


In the SYSGEN prompts, parameters enclosed in brackets ({]) are 
permitted only in the response for the first controller. Parameters 
enclosed in parenthesis (()) are required only if the indicated option 
is present in the target system. 


Some devices require common parameters. To display the specific 
device question, SYSGEN groups the devices that require common 
parameters together and then shares the respective SYSGEN prompt line. 
Table 5-1 lists all the SYSGEN prompt lines and the devices that use 
each. 


The device specific questions display default values for the 
parameters listed in the SYSGEN prompt line. When the question does 
not display a parameter, you must enter a value for that parameter. A 
comma (,) is the parameter delimiter. Note that blanks or tabs are 
not permitted between parameters, 


When you specify a required parameter or override the default value, 
SYSGEN applies a minimum and maximum range (the acceptable range) for 
each parameter. If the value you enter is not within the acceptable 
range, SYSGEN issues an error message that identifies the parameter by 
number, according to its position in the prompt line. Note that if 
your system includes loadable driver support, the optional L/R 
parameter is not included in the parameter count. For example, if you 
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enter 300 as the CSR address for a CR11 controller (SYSGEN prompt 1), 
SYSGEN displays: 


SGN -- Parameter (#2) "300" out of range 160000 to 177700 -- RETRY 


and then repeats the question. The number in parenthesis is the 
parameter count (excluding L/R if applicable) and the value in quotes 
is the invalid parameter. 


CAUTION 


When you enter a numeric response, do 
not include a period (to specify 
decimal) or a pound sign (to specify 
octal). This will cause an error; 
SYSGEN attempts to validate your 
response and does not permit explicit 
decimal or octal entries. 


Enter numeric values within the 
acceptable range. SYSGEN interprets the 
response to be octal or decimal as 
required. 


Refer to the detailed description if you 
are unsure of the base for a specific 
numeric response. 


Table 5-1 
SYSGEN Prompt Lines 


Enter [L/R,] vector, CSR for: 


Devices that use this prompt are (group 1 devices): CR11 card 
reader (CR:), TAl1 cassette (CT:), RF disks (DF:), TSO4 magtape 
(MS:), PCll paper tape punch (PP:), PC11/PR11 paper tape reader 
(PR:), UDC11l universal digital controller (UD:), DA11 parallel 
line interface (XB:) 


Enter [L/R,] vector, CSR, number of drives, unit number of first drive, 
[O=offset recovery support/NO=no support] for: 

Devices that use this prompt are (group 2 devices): RP04/05/06 
disk packs (DB:), RM0O2/03 disks (DR:) 

Enter [L/R,] vector, CSR, number of drives for: 
Devices that use this prompt are (group 3 devices): TU58 DECtape 
II (DD:), RLO1 cartridge disks (DL:), RP02/03 disks (DP:), TCll 
DECtape (DT:), RXOl1 floppy disk (DX:), RX02 floppy disk (DY:), 
TU45/TU16/TE16/TU77 magtapes (MM:), TSO03/TU10/TE10 magtapes (MT: ) 


(continued on next page) 
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Table 5-1 (Cont.) 
SYSGEN Prompt Lines 


Enter [L/R,] vector, CSR, F=full duplex/H=half duplex, 
E=error detec. unit/NO=no, C=char., detec. unit/NO=no, 
number of sync characters in leader for: 


Devices that use this prompt are (group 4 devices): DQl1 
synchronous line interface (XQ:) 


Enter [L/R,] vector, CSR, number of drives, unit number of first drive for: 


Devices that use this prompt are (group 5 devices): RS03/04 
disks (DS:) 

Enter [L/R,] vector, CSR, highest unit number <0 to 7> for: 
Devices that use this prompt are (group 6 devices): RKOS 
cartridge disks (DK:) 

Enter vector, CSR, VT11/VS60, number of CRT monitors for: 
Devices that use this prompt are (group 7 devices): VT11/VS60 
graphics display;processor and scope (GR:) 

Enter [L/R,] CSR, number. of A/D channels for: 
Devices that use this prompt are (group 8 devices): ADO1 
analog-to-digital converter (AD:) 

Enter [L/R,] vector, CSR, number of A/D channels for: 


Devices that use this prompt are (group 9 devices): AFC1l1l 
analog-to-digital converter (AF:;) 


Enter [L/R,] clock vector, CSR, polarity mask, D=D/A channel/NO=no, 
maximum number of samples/second, DRK=DR11-K/NO=no, 
(,DR11-K CSR) for: 


Devices that use this prompt are (group 10 devices): AR11 
laboratory peripheral system (AR:) 


Enter [L/R,] clock vector, CSR, #A/D channels, G=gain ranging option /NO=no, 


polarity mask, bandwith filter channel select delay, 
number of D/A channels, D=digital I/O option/NO=no, 
maximum number of samples/second for: 


Devices that use this prompt are (group 11 devices): LPS11l 
laboratory peripheral system (LS:;) 


(continued on next page) 
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Table 5-1 (Cont.) 
SYSGEN Prompt Lines 

Enter [(L/R,] vector, CSR (, number of UMRS) for: 

Devices that use this prompt are (group 12 devices): LPA11-K 
laboratory peripheral accelerator (LA:) 

Enter [L/R,] vector, CSR, #drives, O=offset recovery/NO=no offset rec. for: 
Devices that use this prompt are (group 13 devices): RKO06/07 
cartridge disks (DM:) 

Enter [L/R,] vector, CSR, F=full duplex/H=half duplex 

number of characters in syne leader for: 
Devices that use this prompt are (group 14 devices): DL11-E 
asynchronous line interface (XL:), DP1ll synchronous’ line 
interface (XP:), DU11 synchronous line interface (XU:), DUPI11 
synchronous line interface (XW:) 

Enter [L/R,] vector, CSR, F=full duplex/H=half duplex/P=primary HDX for: 
Devices that use this prompt are (group 15 devices): DMC 
interprocessor link (XM:) 

Enter [L/R,] vector, CSR, printer type 

(, [KMC timeout count <0=no KMC>, KMC vector, KMC CSR]) for: 
Devices that use _ this prompt are (group 16 devices): 
LAL80/LS11/LP11/LV11 line printers (LP:) 

Enter number of modules, module number of first for: 

Devices that use this prompt are (group 17 devices): upDc ADUO] 
analog input module, UDC analog output module, UDC bi-stable 


output module, UDC digital interrupt module, UDC digital sense 
module, UDC I/0 counter module, UDC single-shot output module 


(all UD:) 

Enter [L/R,] terminal number to redirect to (TTn:) for: 
Devices that use this prompt are (group 18 devices): Console 
output device (pseudo device CO:) with console logging enabled 

Enter [L/R,] num. DL11l's <ZL>, num. DH11's, num. DZl1l's, num. DJlil's for 


Devices that use this prompt are (group 19 devices): Half duplex 
terminal driver, baseline terminal driver 


(continued on next page) 
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Table 5-1 (Cont.) 
SYSGEN Prompt Lines 


Enter num. DL11's <ZL>, num. DH11's, num. DZ1ll's num. DJ11's for: 
Devices that use this prompt are (group 20 devices): Full duplex 
terminal driver 

Enter vector, CSR for: 

Devices that use this prompt are (group 21 devices): DL11 


asynchronous’ line interface (TT:). SYSGEN refers to this device 
as ZL. 


Enter vector, CSR, highest line number <0 to 15> 
(, answer speed, DM11-BB vector, DM11-BB CSR) for: 


Devices that use this prompt are (group 22 devices): DH11 
terminal interface (TT:). SYSGEN refers to this device as DH. 


Enter vector, CSR, highest line number <0 to 15> for: 


Devices that use this prompt are (group 23 devices): DJ11 
terminal interface (TT:). SYSGEN refers to this device as DJ. 


Enter vector, CSR, highest line number <0 to 7> [, answer speed] for: 


Devices that use this prompt are (group 24 devices): DZ11 
terminal interface (TT:). SYSGEN refers to this device as DZ. 


The following is a detailed description of all the possible peripheral 
questions. 


Enter [L/R,] vector, CSR for: 
1. CR controller 0 [D:230,177160] 


Enter the interrupt vector address (the default value is 230) 
and the CSR address (the default value is 177160) for the 
first CR11 card reader controller. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent CR11 controllers do not default the vector and CSR 
assignments; you must enter a value within the acceptable 
range. 


1. CT controller 0 [D:260,177500] 


Enter the interrupt vector address (the default value is 230) 
and the CSR address (the default value is 177160) for the 
first TAl1 cassette controller. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 
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Subsequent TAl1 controllers do not default the vector and CSR 
assignments; you must enter a value within the acceptable 
range. 


DF controller 0 [D:204,177460} 


Enter the interrupt vector address (the default value is 204) 
and the CSR address (the default value is 177260) for the 
first RF11 controller. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent RF1l controllers do not default the vector and CSR 
assignments; you must enter a value within the acceptable 
range. 


MS controller 0 [D:224,172522] 


Enter the interrupt vector address (the default value is 224) 
and the CSR address (the default value is 172522) for the 
first TS11 controller. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR. 


Subsequent TS11 controllers do not default the vector and CSR 
assignments; you must enter a value within the acceptable 
range. 


PP controller 0 [D:74,177554] 


Enter the interrupt vector address (the default value is 74) 
and the CSR address (the default value is 177554) for the 
first PCll controller. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent PC1ll controllers do not default the vector and CSR 
assignments; you. must enter a value within the acceptable 
range. 


PR controller 0 [(D:70,177550] 


Enter the interrupt vector address (the default value is 70) 
and the CSR address (the default value is 177550) for the 
first PC1l1/PR11 controller. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent PC11/PR11 controllers do not default vector and 
CSR assignments; you must enter a value within the 
acceptable range. 


DETAILS OF SYSGEN PHASE I 


UD controller 0 [D:234,171776] 


Enter the interrupt vector address (the default value is 234) 
and the CSR address (the default value is 171776) for the 
UDC11 controller. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


After you specify the interrupt vector address and the CSR 
address for the UDC11, SYSGEN immediately prompts for UDC11l 
module information using SYSGEN prompt line 17. For clarity, 
this section lists the prompt lines in numeric order, not in 
logical sequence. If you were performing a SYSGEN and 
included a UDC1l1l controller, the questions for UDC1l1 would 
follow the vector and CSR assignments. 


XB controller 0 [D:124,172414] 


Enter the interrupt vector address (the default value is 124) 
and the CSR address (the default value is 172414) for the 
first DAl1-B interface. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent DA11-B interfaces do not default the vector and 
CSR assignments; you must enter a value within the 
acceptable range. 


Enter [L/R,] vector, CSR, number of drives, unit number of first drive, 


[O=offset recovery support/NO=no support] for: 


DB controller 0 [254,176700,,0,0] 


Enter the interrupt vector address (the default is 254), the 
CSR address (the default is 176700), the number of RP04/05/06 
drives (there is no default for this parameter), the unit. 
number of the first drive (the default for the first physical 
unit number is 0), and whether or not the controller supports 
offset recovery (the default is 0, to support offset 
recovery) for the first RH11 or RH70 controller. 


Offset recovery support provides a higher degree of data 
integrity in environments where disk packs are frequently 
moved from drive to drive. This support moves the disk head 
on either side of the cylinder centerline in an attempt to 
pick up a stronger signal. Thus, offset recovery support 
allows data to be read in instances where it could not 
otherwise be recovered. 


If you use the default values (enter two commas (,,) followed 
by the number of drives), the acceptable range for the number 
of drives is 1-8. 
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I€ you do not use the default values, the acceptable ranges 
(response) are: 


vector 60-774 (octal) 

CSR 160000-177700 (octal) 
number of drives 1-8 (decimal) 

unit number of first drive 1-7 (decimal) 

offset recovery O or NO 


Subsequent RH11 or RH70 controllers for IB: default only the 
unit number of the first drive (to 0). 


NOTE 


You can only specify offset recovery 
support for the first DB controller. If 
you include support for the first 
controller, you automatically include 
offset recovery support for subsequent 
controllers. Likewise, if you exclude 
support, you exclude offset recovery 
support for subsequent controllers. 


After you enter the parameters for each RH11 or RH70 
controller included in your system, SYSGEN immediately 
prompts for drive type using SYSGEN prompt line 52. For 
clarity, this section lists the prompt lines in numeric 
order, not in logical sequence. If you were performing a 
SYSGEN and included an RH11 or RH70 controller for DB: 
devices (RP04/05/06), the questions that specify the type of 
drive would follow the DB controller parameter specification. 


DR controller 0 [D:254,176700,,0,0] 


Enter the interrupt vector address (the default is 254), the 
CSR address (the default is 276700), the number of RM02/03 
drives (there is no default for this parameter), the physical 
unit number of the first drive (the default is 0), and 
whether or not the controller supports offset recovery (the 
default is 0, to support offset recovery) for the first RH11l 
or RH70 controller. 


Offset recovery support provides a higher degree of data 
integrity in environments where disk packs are frequently 
moved from drive to drive. This support moves the disk head 
on either side of the cylinder centerline in an attempt to 
pick up a stronger signal. Thus, offset recovery support 
allows data to be read in instances where it could not 
otherwise be recovered. 


If you use the default values (enter two commas (,,) followed 
by the number of drives), the acceptable range for the number 
of drives is 1-8. 
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If you do not use the default values, the acceptable ranges 
(response) are: 


vector 60-774 (octal) 

CSR 160000-177700 (octal) 
number of drives 1-8 (decimal) 

unit number of first drive 0-7 (decimal) 

offset recovery O or NO 


Subsequent RH11 or RH70 controllers for DR: default only the 
unit number of the first drive (to 0). 


NOTE 


You can only specify offset recovery 
support for the first DR controller. If 
you include support for the first 
controller, you automatically include 
offset recovery support for subsequent 
controllers. Likewise, if you exclude 
Support, you exclude offset recovery 
support for subsequent controllers. 


After you enter the parameters for each RH11 or RH70 
controller included in your system, SYSGEN immediately 
prompts for drive type using SYSGEN prompt line 56. For 
clarity, this section lists the prompt lines in numeric 
order, not in logical sequence. If you were performing a 
SYSGEN and included an RH11 or RH70 controller for DR: 
devices (RM02/03), the questions that specify the type of 
each drive would follow the DR controller parameter 
specification. 


Enter [L/R,] vector, CSR, number of drives for: 


3. 


DD controller 0O [D:300,176500] 


Enter the interrupt vector address (the default value is 
300), the CSR address (the default value is 176500), and the 
number of DECtape II drives (there is no default for this 
parameter) for the first TU58 controller. 


The acceptable range for the number of DECtape II drives is 
1-2. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent TU58 controllers do not default the vector and CSR 
assignments; you must enter a value, within the acceptable 
range, for the vector and CSR assignments as well as_ the 
number of drives. 


DL controller 0 [{D:160,174400] 


Enter the interrupt vector address (the default value is 
160), the CSR address (the default value is 174400), and the 
number of RLO1/02 disk drives (there is no default for this 
parameter) for the first RL11 controller. 


The acceptable range for the number of RLO1/02 disk drives is 
1-4, 
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I£ you do not enter the default values for the 


assignments, the acceptable 
and 160000-177700 for the CSR, 


Subsequent RL11 controllers do 
assignments; you must enter 
range, for the vector and CSR 
number of RLO1/02 drives. 


After you specify the vector 
number of RLO1/02 drives, 
drive type using SYSGEN prompt 
section 
logical sequence. 


and CSR 
SYSGEN 


range is 60-774 
both in octal. 


not default the 
a value, within 
assignments as 


line 53. For 


devices 


vector and CSR 
for the vector 


vector and CSR 
the acceptable 
well as the 


assignments and the 
immediately prompts for 


clarity, this 


lists the prompt lines in numeric order, not in 
If you were performing 
included an RL11 controller for DL: 


a SYSGEN and 
(RLO1/02), the 


questions that specify the type of drive would follow the DL 
controller parameter specification. 


DP controller 0 [{D:254,176714] 


Enter the interrupt vector 


address (the default value is 


254), the CSR address (the default value is 176714), and the 
number of RP02/03 disk drives (there is no default for this 
parameter) for the first RP11 controller. 


The acceptable range for the number of RP02/03 


1-8(10). 


If you do not enter the default values for the 


assignments, the acceptable 
and 160000-177700 for the CSR, 


Subsequent RP11 controllers do 
assignments; you must enter 
range, for the vector and CSR 
number of RP02/03 drives. 


After you specify the vector 
number of RP0O2/03 drives, 
drive type using SYSGEN prompt 
section lists the prompt 


and CSR 
SYSGEN 


range is 60-774 
both in octal. 


not default the 


a value, within 
assignments as 


line 55. For 


logical sequence. If you were performing 


included an RP11il controller for DP: 


devices 


disk drives is 


vector and CSR 
for the vector 


vector and CSR 
the acceptable 
well as the 


assignments and the 
immediately prompts for 


clarity, this 


lines in numeric order, not in 


a SYSGEN and 
(RPO2/03), the 


questions that specify the type of drive would follow the DL 
controller parameter specification. 


DX controller 0 [D:264,177170] 


Enter the interrupt vector 


address (the default value is 


264), the CSR address (the default value is 177170), and the 


number of RXOl floppy disk drives (there is 


this parameter) for the first RX11 controller. 


The acceptable range for the 
drives is 1-2. 


number of RXO1l 


no 


default for 


floppy disk 


If you do not enter the default values for the vector and CSR 


assignments, the acceptable 
and 160000-177700 for the CSR, 


range is 60-774 
both in octal. 


for the vector 
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Subsequent RX11 controllers do not default the vector and CSR 
assignments; you must enter a value, within the acceptable 
range, for the vector and CSR assignments as well as_ the 
number of RX01 floppy disk drives. 


DY controller 0 [D:264,177170] 


Enter the interrupt vector address (the default value is 
264), the CSR address (the default value is 177170), and the 
number of RX02 floppy disk drives (there is no default for 
this parameter) for the first RX211 controller. 


The acceptable range for the number of RX02 floppy disk 
drives is 1-2. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR. 


Subsequent RX211 controllers do not default the vector and 
CSR assignments; you must enter a value, within the 
acceptable range, for the vector and CSR assignments as well 
as the number of RX02 floppy disk drives. 


After you specify the vector and CSR assignments and the 
number of RX02 drives, SYSGEN immediately prompts for drive 
density using SYSGEN prompt line 58. For clarity, this 
section lists the prompt lines in numeric order, not in 
logical sequence, If you were performing a SYSGEN and 
included an RX211 controller for DY: devices (RX02), the 
questions that specify the density of each RX02 drive would 
follow the DY controller parameter specification. 


MM controller 0 [(D:224,172440] 


Enter the interrupt vector address (the default value is 
224), the CSR address (the default value is 172440), and the 
number of TU45, TU16, TE16, or TU77 magtape drives (there is 
no default for this parameter) for the first RH11 or RH70 
controller, TMO2 or TMO3 tape controller. 


The acceptable range for the number of tape drives is 1-8. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent controllers of this type do not default the vector 
and CSR assignments; you musSt enter a value, within the 
acceptable range, for the vector and CSR assignments as_ well 
as the number of tape drives. 


After you specify the vector and CSR assignments and the 
number of TU45, TE16, TU16, or TU77 tape drives, SYSGEN 
immediately prompts for the TMO2 or TMO3 number using SYSGEN 
prompt line 51. For clarity, this section lists the prompt 
lines in numeric order, not in logical sequence. If you were 
performing a SYSGEN and included an MM: device (TU45, TU16, 
TE16, or TU77), the questions that specify the TM02 or TMO3 
number would follow the MM controller parameter 
specification. 
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MT controller 0 [D:224,172522] 


Enter the interrupt vector address (the default value is 
224), the CSR address (the default value is 172522), and the 
number of TS03, TU10, or TE10 magtape drives (there is no 
default for this parameter) for the first TMl11, TMA11, or 
TMB11 controller. 


The acceptable range for the number of tape drives is 
1-8(10). 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent controllers of this type do not default the vector 
and CSR assignments; you must enter a value, within the 
acceptable range, for the vector and CSR assignments as_ well 
as the number of tape drives. 


Enter [L/R,] vector, CSR, F=full duplex /H=half duplex, 


E=error detec. unit /NO=no, C=char. detec unit /NO=no, 
number of sync characters in leader for: 


XQ controller 0 [D:,,H,E,C] 


The vector address for the DQ11 synchronous line interface is 
assigned from the floating vector space starting at 300. 
Thus, there is no default vector address for the DQl1. Enter 
a vector address between 300 and 774. Consult Field Service 
if the vector address is unknown. 

The CSR address for the DQl11 synchronous line interface is 
assigned from the floating address space starting at 160010. 
Thus, there is no default CSR assignment for the DQ11. Enter 
a CSR address between 160010 and 177700. Consult Field 
Service if the CSR address is unknown. 


The first DQ11 line defaults to a half duplex line (H), with 
an error detection expander unit (E), and a character 
detection expander unit (C). Enter F, NO, or NO respectively 
to override these defaults. 


There is no default value for the parameter that specifies 
the required number of sync characters in a syne leader. You 
must enter a value in the range 3-14(10). A typical response 
is 4-6. If the line is to run at high speeds or if the 
expected system load is to be heavy, specify a greater number 
of syne characters. 


Subsequent DQ11 lines do not default any of the parameters; 
you must enter values for the vector and CSR assignments 
(vector range is 300-774, CSR range is 160010-177700 both 
octal), whether the line is half duplex (H) or full duplex 
(F), whether an error detection expander unit is present (E) 
or not (NO), whether a character detection expander unit is 
present (C) or not (NO), and the required number of sync 
characters in a sync leader (range is 3-14 decimal). 


Enter [L/R,] vector, CSR, number of drives, unit number of first drive for: 


5. 
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DS controller 0 [D:204,172040,,0] 


Enter the interrupt vector address (the default value is 
204), the CSR address (the default value is 172040), the 
number of RSO3/04 disk drives (there is no default. value for 
this parameter), and the unit number of the first RS03/04 
drive (the default value is 0) for the first RH11 or RH70 
controller. 


The acceptable range for the number of RS03/04 drives is 1-8. 


If you do not use the default values, the acceptable ranges 
ares 


vector 60-774 (octal) 

CSR 160000-177700 (octal) 
number of drives 1-8 (decimal) 

unit number of first drive 0-7 (octal) 


Subsequent RH11 or RH70 controllers default only the unit 
number of the first drive (to 0). 


After you enter the parameters for each RH11 or RH70 
controller included in your system, SYSGEN immediately 
prompts for drive type using SYSGEN prompt line 57. For 
clarity, this section lists the prompt lines in numeric 
order, not in logical sequence. If you were performing a 
SYSGEN and included an RH11 or RH70 controller for DS: 
devices (RS03/04), the questions that specify -whether each 
drive is an RSO3 or an RSO4 would follow the DS controller 
parameter specification. 


Enter [L/R,] vector, CSR, highest unit number <0 to 7> for: 


6. 


DK controller 0 [D:220,177404] 


Enter the interrupt vector address (the default value is 
220), the CSR address (the default value is 177404), and the 
highest RKO5 unit number (there is no default value for this 
parameter) for the first RK11 controller. 


The acceptable range for the highest RKO5 unit number is 0-7. 
Note that if you want the first RKO5 unit number to be 0, 
enter the number of RKOS drives minus one as the highest unit 
number, 


If you do not enter the default vector and CSR assignments, 
the acceptable range is 60-774 for the vector and 
160000-177700 for the CSR, both in octal. : 


NOTE 


Fixed platter RKO5 drives (RKOSF) are 
handled as two units. The first of each 
RKO5F pair must be an even unit number; 
for example, 0 and 1, 2 and 3. Be sure 
to take this into account when you 
calculate the highest RKO5 unit number. 


we 
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Enter vector, CSR, VT11/VS60, number of CRT monitors for: 


Ve 


GR controller 0 [D:,172000,,1] 


RSX-11M supports the graphics display subsystem with the 
following restrictions. 


1. One, and only one, VT11 or VS60 in the system 


2. The graphics display driver does not operate on PDP-11/70 
processors in 22-bit mode; memory size must be less than 
or equal to 124K-words. 


3. For systems using the VT1l1, the display buffer of the 
task driving the VT11 must completely reside in the low 
28K-words of system memory 


The vector address for the graphics display subsystem is 
assigned from the floating vector space starting at 300. 
Thus, there is no default vector address for the graphics 
display subsystem. Enter a vector address between 300 and 
774. Consult Field Service if the vector address is unknown. 


After you specify the vector address, enter the CSR address 
(the default value is 172000), whether the connected terminal 
is a VT1l or a VS60 (there is no default for this parameter), 
and the number of CRT monitors (the default value is 1). 


If you do not enter the default values for the CSR assignment 
and the number of CRT monitors, the acceptable range is 
160000-177700 for the CSR and 1-2 for the number of CRT 
monitors, all in octal. 


NOTE 


Only the vS60 can drive two CRT monitors 
independently. Thus, if your system 
includes the VT1l1 you must specify one, 
the default value, for the number of CRT 
monitors. 


Enter [L/R,] CSR, number of A/D channels for: 


8.. 


AD controller 0 [D:176770] 


The ADO1-D analog-to-digital converter is a non-interrupt 
device. Therefore, you do not’ enter an interrupt vector 
address. 


Enter the CSR address (the default value is 176770) and_ the 
number of A/D channels (there is no default for this 
parameter) for the first ADOQ1-D controller. 


The acceptable range for the number of A/D channels is 
1-64(10). If you do not enter the default value for the CSR 
assignment, the acceptable range is 160000-177700 (octal). 


Subsequent ADO1-D controllers do not default the CSR 


assignment; you must enter a value within the acceptable 
range. 
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Enter [L/R,] vector, CSR, number of A/D channels for: 


9. 


AF controller 0 [D:134,172570] 


Enter the interrupt vector address (the default value is 
134), the CSR address (the default value is 172570), and the 
number of A/D channels (there is no default for this 
parameter) for the first AFC1l controller. 


The acceptable range for the number of A/D channels is 
1-1024(10). 


I£ you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent AFC1l1 controllers do not default the vector and 
CSR assignments; you must enter a value, within the 
acceptable range, for the vector and CSR assignments as well 
as the number of A/D channels. 


Enter [L/R,] clock vector, CSR, polarity mask, D-D/A channel /NO=no, 


10. 


maximum number of samples/second, DRK=DR11~-K/NO=no 
(,DR11-K CSR) for 


AR controller 0 [D:,170400,,,,,170420] 


The clock vector address for the AR11 controller is assigned 
from the floating vector space starting at 300. It is 
located at an offset of four (4) from the beginning of the 
AR11 vector space. Thus, there is no default clock vector 
address for the AR11. Enter a clock vector address between 
300 and 774. Consult Field Service if the clock vector 
address is unknown. 


The standard CSR address for the AR11 is 170400. Specify the 
address of the first word of the AR11 CSR group (the default 
value is 170400). If you do not enter the default CSR 
address, the acceptable range is 160000-177700. 


The polarity mask word specifies whether an individual 
channel is uni-polar or bi-polar; it corresponds one-to-one 
with the 16 possible channels. A 1-bit designates a 
uni-polar channel and a O-bit designates a bi-polar channel. 
The acceptable range for the polarity mask word is 0-177777 
octal (0 specifies 16 bi-polar channels, 177777 specifies 16 
uni-polar channels). 


The AR11 module includes a D/A converter. However, support 
for the D/A is optional in the driver. If you do not include 
support (enter NO for parameter 4), the driver will be 
significantly shorter. 


The maximum number of samples must be evenly divisible into 
10,000 and within the acceptable range of 1-2500(10). 


The AR11 does not include the 16-bit digital I/O option that 
is available with the LPS11. However, you can achieve the 
same functionality using the DR11-K. The * DR11-K must’ be 
jumper selected to use the 16 individual input lines without 
interrupts. If the DR11-K option is present, enter the CSR 
address of the DR11-K (the default value is 170420). I£ you 
do not enter the default DR11-K CSR address, the acceptable 
range is 160000-177700, octal. 


5-58 
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Subsequent AR11 controllers default only the CSR address of 
the DR11-K option; you must enter values within the 
acceptable ranges. Also, if subsequent AR11 controllers do 
not include the DR11-K option, you must exclude this 
parameter. 


Enter [L/R,] clock vector, CSR, #A/D channels, G=gain ranging option /NO=no, 
polarity mask, bandwith filter channel select delay, 
number of D/A channels, D=digital I/O option /NO=no, 
maximum number of samples/second for: 


11. LS controller 0 [D:,170400,,,0,0,0,NO] 


The clock vector address for the LPS1l1 controller is assigned 
from the floating vector space starting at 300. It is 
located at an offset of four (4) from the beginning of the 
LPS11 vector space. Thus, there is no default clock vector 
address for the LPS1l1. Enter a clock vector address between 
300 and 774 octal. Consult Field Service if the clock vector 
address is unknown. 


The standard CSR address for the LPS1l1 is 170400. Specify 
the address of the first word of the LPS11 CSR group (the 
default value is 170400). If you do not enter the default 
CSR address, the acceptable range is 160000-177700 octal. 


The next parameter is the number of A/D channels; enter a 
value in the range 1-64(10) to specify the number of A/D 
channels on the first LPS11 controller. 


You must then enter whether or not the gain ranging option is 
presént. If the gain ranging option is present, you must 
specify the polarity mask word and the bandwith filter 
channel select delay (if required). 


The polarity mask word specifies whether an individual 
channel is uni-polar or bi-polar; it corresponds one-to-one 
with the 16 possible channels. A l-bit designates a 
uni-polar channel and a 0-bit designates a bi-polar channel. 
The acceptable range for the polarity mask word is 0-177777 
octal (0 specifies 16 bi-polar channels, 177777 specifies 16 
uni-polar channels). 


With bandwith filtering enabled, the LPS11 driver imposes a 
software delay between changing channels on the multiplexer 
and initiating an A/D conversion. This delay can range from 
85 usec to 8.5 msec. Consult the LPS11 documentation to 
determine the proper delay for your application. Note that 
the response must be in 100 usec units (for example, specify 
25 to delay 2.5 msec). The acceptable range is 0-85. Enter 
0 to disable bandwith filtering. 


If your system includes the D/A option, enter the number of 
channels in the range 0-10(10). A response of 0 indicates 
the option is not present. The first two D/A channels 
correspond to the xX and Y registers of the display 
controller. Up to eight additional D/A channels may be 
specified if the external D/A option is present. 
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The LPS11 supports a digital I/O and relay module. You must 
specify whether or not the option is present. You then enter 
the maximum number of samples per second. The acceptable 
range is 1-2500(10). Note that this value must be a multiple 
of 10,000 (1, 2, 4, 5, 8, 10, 16, 20, 25, 40, 50, 80, 100, 
125, 200, 250, 400, 500, 625, 1000, 1250, 2000, or 2500). 


Enter [L/R,] vector, CSR (, number of UMRs) for 


12. 


Enter [L/R,] vector, CSR, # drives, O=offset recovery /NO=no offset rec. 


13. 


LA controller 0 [D:300,170460,0] 


Enter the interrupt vector address (the default value is 
300), the CSR address (the default value is 170460), and the 
number of UNIBUS Mapping Registers (UMRsS) for the LPA11-K. 


The UMR parameter applies only to PDP-11/70 processors with 
extended memory (22-bit mapping) support. Enter a value to 
specify the maximum number of UMRs that the LPAl1=-K driver 
can use to map all currently active LPAl1-K I/O transfers. 
See the RSX-11M/M-PLUS I/0 Drivers Reference Manual for 
details. 


NOTE 


The vector address is assigned from 
floating vector space. Consult Field 
Service if the location is unknown. 
Also, the required CSR address is that 
of the first word of the LPAl11 CSR 
group. Again, consult Field Service if 
unknown. 


DM controller 0 [230,177440,,0] 


Enter the interrupt vector address (the default value is 
210), the CSR address (the default value is 177440), the 
number of RKO6/07 disk drives (there is no default for this 
Parameter), and whether or not the controller is to support 
offset recovery (the default is to include offset recovery 
support (0)) for the first RK611 controller. 


The acceptable range for the number of RKO6/07 drives is 
1-8(10). 


Offset recovery support provides a higher degree of data 
integrity in environments where disk packs are frequently 
moved from drive to drive. This support moves the disk head 
on either side of the cylinder centerline in an attempt to 
pick up a stronger signal. Thus, offset recovery support 
allows data to be read in instances where it could not 
otherwise be recovered. 


If you do not use the default vector and CSR assignments, the 
acceptable range is 60-774 for the vector and 160000-177700 
for the CSR, both octal. 


for: 
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Subsequent RK61l1 controllers do not default the vector and 
CSR assignments; you must enter a value, within the 
acceptable range, for the vector and CSR assignments as well 
as the number of RKO06/07 drives. 


NOTE 


You can only specify offset recovery 
support for the first controller. If 
you include support for the first RK611 
controller, you automatically include 
offset recovery support for subsequent 
controllers. Likewise, if you exclude 
support, you exclude offset recovery 
support for subsequent RK611 
controllers. 


After you enter the parameters for each RK611 controller 
included in your system, SYSGEN immediately prompts for drive 
type using SYSGEN prompt line 54. For clarity, this section 
lists the prompt lines in numeric order, not in logical 
sequence. If you were performing a SYSGEN and included an 
RK611 controller for DM: devices (RK06/07), the questions 
that specify whether each drive is an RKO6 or an RKO7 would 
follow the DM controller parameter specification. 


Enter [L/R,] vector, CSR, F=full duplex /H=half duplex, 


14. 


number of characters in syne leader for: 
XL controller O [D:,,H] 


The vector address for the DLL1-E asynchronous line interface 
is assigned from the floating vector space starting at 300. 
Thus, there is no default vector address for the DL11-E. 
Enter a vector address between 300 and 774. Consult Field 
Service if the vector address is unknown. 


The CSR address for the DL11-E asynchronous line interface is 
assigned from the floating address space starting at 175610. 
Thus, there is no default CSR assignment for the DL11-E. 
Enter a CSR address between 175610 and 177700 octal. Consult 
Field Service if the CSR address is unknown. 


The first DL11-E line defaults to a half duplex line (H). 
Enter F to specify a full duplex line. 


There is no default value for the parameter that specifies 
the required number of sync characters in a sync leader. You 
must enter a value in the range 3-14(10). A typical response 
is 4-6. If the line is to run at high speeds or if the 
expected system load is to be heavy, specify a greater number 
of syne characters. 


Subsequent DL11-E lines do not default any of the parameters; 
you must enter values for the vector and CSR assignments 
(vector range is 300-774, CSR range is 175610-177700), 
whether the line is half duplex (H) or full duplex (F), and 
the required number of syne characters in a sync leader 
(range is 3-14). 


14. 


14. 
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XP controller 0 [D:,174770,H] 


The vector address for the DPll synchronous line interface is 
assigned from the floating vector space starting at 300. 
Thus, there is no default interrupt vector address for the 
DPll. Enter a vector -address between 300 and 774 octal. 
Consult Field Service if the vector address is unknown. 


The standard CSR assignment for the DP1l is 174770. If you 
do not enter the default CSR address, enter a value in the 
range 160000-177700 octal. : 


The first DP1l line defaults to a half duplex line (H). 
Enter F to specify a full duplex line. 


There is no default value for the parameter. that specifies 
the required number of sync characters in a sync leader. You 
must enter a value in the range 3-14(10). A typical response 
is 4-6. If the line is to run at high speeds or if the 
expected system load is to be heavy, specify a greater number 
of sync characters, 


Subsequent DP1ll lines default only the half duplex parameter 
(H); you must enter values for the vector and CSR 
assignments (vector range is 300-774, CSR range is 
160000-177700 both octal), and the required number of sync 
characters in a sync leader (range is 3-14 decimal). 


XU controller O [D:,,F] 


The vector address for the DU11 synchronous line interface is 
assigned from the floating vector space starting at 300. 
Thus, there is no default interrupt vector address for the 
DULI. Enter a vector address between 300 and 774 octal. 
Consult Field Service if the vector address is unknown. 


The CSR address for the DU11 synchronous line interface is 
assigned from the floating address space starting at 160010. 
Thus, there is no default CSR assignment for the DUl11. Enter 
a CSR address between 160010 and 177700 octal. Consult Field 
Service if the CSR address is unknown, 


The first DU11 line defaults to a full duplex line (F). 
Enter H to specify a half duplex line. 


There is no default value for the parameter that specifies 
the required number of sync characters in a syne leader You 
must enter a value in the range 3-14(10). A typical response 
is 4-6, If the line is to run at high speeds or if the 
expected system load is to be heavy, specify a greater number 
of sync characters. : 


Subsequent DU11 lines default only the full duplex parameter 
(F); you must enter values for the vector and CSR 
assignments (vector range is 300-774, CSR range is 
160010-177700 both octal), and the required number of sync 
characters in a syne leader (range is 3-14 decimal). 
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14. XW controller 0 [D:,,H] 


The vector address for the DUP11 synchronous line interface 
is assigned from the floating vector space starting at 300. 
Thus, there is no default interrupt vector address for the 
DUP11. Enter a vector address between 300 and 774 octal. 
Consult Field Service if the vector address is unknown. 


The CSR address for the DUP11 synchronous line interface is 
assigned from the floating address space starting at 160010. 
Thus, there is no default CSR assignment for the DUPII1. 
Enter a CSR address between 160010 and 177700 octal. Consult 
Field Service if the CSR address is unknown. 


The first DUP11 line defaults to a half duplex line (H). 
Enter F to specify a full duplex line. 


There is no default for the parameter that specifies the 
required number of sync characters in a sync leader. You 
must enter a value in the range 3-14(10). A typical response 
is 4-6. If the line is to run at high speeds or if the 
expected system load is to be heavy, specify a greater number 
of sync characters. 


Subsequent DUP11 lines do not default any of the parameters; 
you must enter values for the vector and CSR assignments 
(vector range is 300-774, CSR range is 160010-177700 both 
octal), whether the line is half duplex (H) or full duplex 
(F), and the required number of sync characters in a syne 
leader (range is 3-14 decimal). 


Enter [L/R,] vector, CSR, F=full duplex/H=half duplex /P=primary HDX for: 
15. XM controller 0 


The vector address for the DMCll interprocessor link is 
assigned from the floating vector space starting at 300. 
Thus, there is no default interrupt vector address for the 
DMCll. Enter a vector address between 300 and 774 octal. 
Consult Field Service if the vector address is unknown. 


The CSR address for the DMC11 interprocessor link is assigned 
from the floating address space starting at 160010. Thus, 
there is no default CSR assignment for the DMCll. Enter a 
CSR address between 160010 and 177700 octal. Consult Field 
Service if the CSR address is unknown. 


Normally, the DMCll is a full duplex serial communications 
link. When the DMCll is used on a half duplex line, one end 
of the line must be the primary station and the other end 
must be the secondary station. Specify an H to indicate that 
the line is a secondary station or P to indicate that the 
line is a primary station. 
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Enter [L/R,] vector, CSR, printer type 


16. 


(, [KMC timeout count <0=noKMC>, KMC vector, KMC CSR]) for: 


LP controller 0 [D:200,177514,LA180,0,300,160130] 


Enter the interrupt vector address (the default value is 
200), the CSR address (the default value is 177514), and the 
printer type (the default type is LAl80) for the first LP 
controller. Valid printer types are: LA180; LP1l1-c; 
LP11-D; LPl1-F; LP11-H; LP1l1-J; LP11-K; LP11-R; LP1l1-S; 
LP1l1-V; LPl1-wW; LPl1-Y; LP11-Z; LS11; LV1ll. For printer 
widths and speed, consult Field Service or the PDP-11l 
Peripherals Handbook. 


If your system includes KMC line printer support, you must 
enter the KMC timeout count (the default of 0 excludes KMC 
support), the KMC interrupt vector address (the default value 
is 300), and the KMC CSR address (the default value is 
160130). 


The timeout count specifies the interval in which the KMC 
polls the line printer between print lines. This value is 
measured in units of 50 micro seconds. For example, if you 
enter 1, the KMC polls the line printer every 100 micro 
seconds (as each print buffer empties). The acceptable range 
is 0-100 decimal. For slower printers, poll less frequently 
(enter a higher number) ; the polling interval 
increases/decreases UNIBUS latency. 


The acceptable range for the KMC interrupt vector address is 
60-774 and for the KMC CSR address the range is 
160000-177700, both in octal. 


NOTE 
If you select KMC support, all printers 


must use the KMC; those that do not 
will not operate, 


You can connect a maximum of eight line printers to the 
system. 


Enter number of modules, module number of first for: 


17. 


UD controller 0 xxxx module 


NOTE 


If you specified a UDC1l1 controller, 
this SYSGEN prompt line and the 
questions that follow appear immediately 
after you enter the vector and CSR 
assignments for the UDC11l. 


The UDC11 supports up to 252 modules, which can be classified 
into seven types: 


e Analog input 
e Analog output 
e Bi-stable output 


* 


17. 
17. 
17. 
17. 
17. 
17. 


17. 
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Digital interrupt 
Digital sense 

I/O counter 
Single-shot output 


Modules of the same type must occupy consecutive locations 
within the UDCi1l. Thus, if there are seven analog input 
modules and the first module starts at slot 0, then the last 
analog input module must be at slot 6. Module types cannot 
overlap, but unassigned slots are permitted. 


SYSGEN asks the following questions to establish UDC1l1l module 
boundaries, You must enter the number of each module 
contained in the UDC1l and identify the slot for that module 
to begin. The permissible range for each entry is 0-252(10). 
Note, however, that SYSGEN decrements the range value for the 
number of each module by the total number of previously 
specified UDCll modules. For example, if you specify 50 
analog input modules, you are limited to 152 of the other 
modules (maximum 252 UDC1l modules). Both responses are in 
octal. 


UD controller 0 ADUO] analog input module 
UD controller 0 analog output module 

UD controller 0 bi-stable output module 
UD controller 0O digital interrupt module 
UD controller 0 digital sense module 

UD controller 0 I/O counter module 


UD controller 0 single-shot output module 


Enter [L/R,] terminal number to redirect to (TTn:) for: 


18. 


Enter [L/R,] num. DL1l1's <ZL>, num. DH11's, num. DZ1ll's, num. DJ1ll's for: 


19. 


CO controller 0 [D:0] 


This poorly phrased question requests a terminal number. The 
console output driver redirects the pseudo device CO: to the 
terminal you specify. 


The default is 0 (TTO:). 


If you do not use the default value, the acceptable range is 
0-77 octal. 


The terminal driver [D:1,0,0,0] 


This question appears only if you selected either one of the 
half duplex drivers including the baseline driver. (The full 
duplex terminal driver is always loadable and appears in 
question 20.) 


For RSX-11M systems, you muSt generate at least one ODL11 
asynchronous terminal interface into the system. RSX-11S 
does not require a DL11. 


All responses are in decimal. 
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Enter the number of each type of terminal interface included 
in your system. The default response includes one DL11 
asynchronous terminal interface. If you do not use _ the 
default response, the acceptable range is 1-8 for the DL11 
and 0-16 for the DH11, DZ1ll, and DJ11 terminal interfaces. 


Enter num. DL11's <ZL>, num. DH11l's, num. DZll's, num. DJ1l's for: 


20. 


The terminal driver [D:1,0,0,0] 


This question appears only if you selected the full duplex 
terminal driver. Note that the optional Loadable/Resident 
parameter does not appear since the full duplex driver is 
always loadable. 


For RSX-11M system, you must generate at least one DLIi) 


asynchronous terminal interface into the system. RSX-115 
does not require a DLIl. 


All responses are in decimal. 


Enter the number of each type of terminal interface included 
in your system. The default response includes one DLI11 
asynchronous terminal interface. If you do not use the 
default response, the acceptable range is 1-8 for the DL11 
and 0-16 for the DH11, DZ1l1, and DJ11l terminal interfaces. 


Enter vector, CSR for: 


21. 


ZL controller O [(D:60,177560] 


This question always appears; you must include at least one 
DL11 line interface in an RSX-11M system. 


The standard interrupt vector address for the first DL11 line 
is 60. If you do not use the default vector assignment, the 
acceptable range is 60-774 octal. 


The standard CSR address for the first DL11 line is 177560. 
If you do not use the default CSR assignment, the acceptable 
range is 160000-177700 octal. 


If you specified more than one DL11, you must enter’ the 
vector and CSR assignment for each additional line. 


Interrupt vector addresses for additional DL11 lines are 
assigned from the floating vector space starting at 300. 
There is no default vector address for any additional DL11 
lines. You must enter a value within the range 300-774 
octal. Consult Field Service if the interrupt vector address 
of additional lines is unknown. 


CSR addresses for additional DL11 lines are assigned from 
floating address space starting at 176000. There is no 
default CSR address for any additional DL11 lines. You must 
enter a value within the range 176000-176770 octal. Consult 
Field Service if the CSR address of additional lines is 
unknown. 
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Enter vector, CSR, highest line number <0 to 15> 


22. 


(, answer speed, DM11-BB vector, DM11-BB CSR) for: 
DH controller O [D:,,,300,0,0] 


This question appears only if you specified a DH11 
asynchronous line interface. Note that the Loadable/Resident 
parameter does not appear. 


The interrupt vector address for the DH1l is assigned from 
floating vector space starting at location 300. Thus, there 
is no default vector assignment for the DH1l. Enter a vector 
address between 300 and 774 octal. Consult Field Service if 
the interrupt vector address is unknown. 


The CSR address for the DH1l1 is assigned from floating 
address space starting at 160010. Thus there is no default 
CSR assignment for the DHl11. Enter a CSR address’ between 
160010 and 177700 octal. Consult Field Service if the CSR 
address is unknown. 


The DH11 can service up to 16 remote and local lines. Remote 
lines occupy consecutive line locations. Line assignment is 
by groups of four. Local lines also occupy consecutive line 
locations and their assignment follows the assignment of any 
remote lines specified. Enter the total number of lines 
desired by specifying the highest line number in the range 
0-15 decimal (0 indicates one line, 15 indicates 16 lines). 


If your DH11 includes DM11-BB modem support, you must enter 
the baud rate at which all DH11 remote lines are answered. 
The default answer speed is 300. If you do not use the 
default response, the acceptable answer speed baud rates are 
50, 75, 110, 134.5, 150, 200, 300, 600, 1200, 2400, 4800, or 
9600. If included, you must also specify the DM11-BB vector 
and CSR assignments. The default response of 0 excludes 
DM11-BB modem support. To include DM11-BB modem support, you 
must enter a value for the vector and CSR assignments. 


The DM11-BB interrupt vector address is assigned from 
floating vector space starting at 300. Thus, you must enter 
a value between 300 and 774 octal to include DM11-BB modem 
support. Consult Field Service if the interrupt vector 
address is unknown. 


The standard CSR address for the DM11-BB is 170500. If you 
include DM11-BB support, enter 170500 or a value within the 
range 160000-177700 octal for the CSR assignment. 


SYSGEN repeats this question for each DH11 specified. 


Enter vector, CSR, highest line number <0 to 15> for: 


23. 


DJ controller 0 


This question appears only if you specified a DJ11 
asynchronous line multiplexer. Note that the 
Loadable/Resident parameter does not appear. This is because 
the DJ11l uses the same driver as the DL11 and the DH1l. 
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The interrupt vector address for the DJ11 is assigned from 
floating vector space starting at 300. Thus, there is no 
default vector assignment for the DJll. Enter a vector 
address between 300 and 774 octal. Consult Field Service if 
the vector address is unknown. 


The CSR address for the DJll is assigned from floating 
address space starting at 160010. Thus , there is no default 
CSR assignment for the DJ11. Enter a CSR address between 
160010 and 177700 octal. Consult Field Service if the CSR 
address is unknown. 


Each DJ11 can service up to 16 asynchronous’ serial lines. 
Enter the total number of lines by specifying the highest 
line number in the range 0 to 15 decimal (0 indicates one 
line, 15 indicates 16 lines). 


SYSGEN repeats this question for each DJ11l specified. 


Enter vector, CSR, highest line number <0 to 7> [, answer speed] for: 


24. 


DZ controller 0 [D:,,,0] 


This question appears only if you specified a DZ11 
asynchronous line multiplexer. Note that the 
Loadable/Resident parameter does not appear. 


The interrupt vector address for the DZ11 is assigned from 
floating vector space starting at 300. Thus, there is no 
default vector assignment for the D2ll. Enter a vector 
address between 300 and 774 octal. Consult Field Service if 
the vector address is unknown. 


The CSR address for the DZ1l is assigned from floating 
address space starting at 160010. Thus, there is no default 
CSR assignment for the DZ11. Enter a CSR address between 
160010 and 177700 octal. Consult Field Service if the CSR 
address is unknown. 


Each DZ11 can service up to 8 asynchronous lines. Enter the 
total number of lines by specifying the highest line number 
in the range 0 to 7 decimal (0 indicates one line, 7 
indicates 8 lines). 


The DZ11 can maintain a full duplex connection through a Bell 
103A type modem. However, modem support requires additional 
code in the terminal database as well as in the driver and 
thus increases system overhead; select modem support only if 
needed. If you wish to include modem support, specify the 
baud rate at which all DZ11 remote lines are to be answered. 
Acceptable answer speed baud rates are 50, 75, 110, 134.5, 
150, 200, 300, 600, 1200, 2400, 4800, or 9600. Note that the 
default for this parameter (0) excludes modem support. 


SYSGEN repeats this question for each DZ1l specified. 
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The following questions provide additional device information and 
immediately follow the respective SYSGEN prompt line for controller 


a information. 
ae 
*51. MM controller 0 unit 0. formatter [D R:0-7 D:0] 
This question immediately follows parameter specification for 
. each MM controller (SYSGEN prompt line 3). You must identify 
the number (the unit plug) for the TM02/03 formatter (tape 
controller) on the RH11 or RH70. The default is 0. If you 
do not use the default response, the acceptable range is 0-7. 
SYSGEN repeats this question for each device unit specified 
_ for each controller. 
*52. Contr 0 unit 0. is an RP04,05/RP06 [D:RP06]} 
This question immediately follows parameter specification for 
each DB controller (SYSGEN prompt line 2). You must specify 
the type of drive. Enter RP06 (the default response), RPO4 
or RPOS. 
: SYSGEN repeats this question for each device unit specified 
‘Nowe’ for each controller. 
*53. Contr 0 unit 0. is an RLO1/RLO2 [D:RLO1] 
This question immediately follows parameter specification for 
each DL controller (SYSGEN prompt line 3). You must specify 
the type of drive. Enter either RLO1 (the default response) 
or RLO2. 
SYSGEN repeats this question for each device unit specified 
en for each controller. 
vow 
*54. Contr 0 unit 0. is an RKO6/RKO7 [D:RK06] 
This question immediately follows parameter specification for 
each DM controller (SYSGEN prompt line 13). You must specify 
the type of drive. Enter either RKO6 (the default response) 
or RKO7. 
SYSGEN repeats this question for each device unit specified 
for each controller. 
aaa *55. Contr 0 unit 0. is an RPO2/RPO3 [D:RPO3] 
This question immediately follows parameter specification for 
each DP controller (SYSGEN prompt line 3). You must specify 
the type of drive. Enter either RPO2 or RPO3 (the default 
response). 
< SYSGEN repeats this question for each device unit specified 
for each controller. 
*56. Contr 0 unit 0. is an RMO2/RMO3 [D:RM03] 


This question immediately follows parameter specification for 
each DR controller (SYSGEN prompt line 2). You must specify 
the type of drive. Enter either RMO2 or RMO3 (the default 
response). 


SYSGEN repeats this question for each device unit specified 
for each controller. 


*57. 


*58. 
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Contr 0 unit 0. is an RSO3/RS04 [D:RS04] 


This question immediately follows parameter specification for 
each DS controller (SYSGEN prompt line 5). You must specify 
the type of drive. Enter either RSO3 or RSO4 (the default 
response), 


SYSGEN repeats this question for each device unit specified 
for each controller. 


Contr 0 unit 0. is SINGLE/DOUBLE density 


This question immediately follows parameter specification for 
each DY controller (SYSGEN prompt line 3). You must specify 
whether each RX02 drive is initially at single density or at 
double density. Enter either SINGLE or DOUBLE. 


SYSGEN repeats this question for each device unit specified 
for each controller. 


If your system includes ICS/ICR process I/0 subsystems or DSS/DRS 


modules, 


SYSGEN asks the following questions. Note that UDCll support 


precludes ICS/ICR support; ICS/ICR and UDC11 are mutually exclusive. 


el 


*2. 


*3. 


*4a, 


*5. 


*6. 


Expanded comments for ICS/ICR questions 


Expanded comments provide explanatory text that helps you 
answer the ICS/ICR questions. 


Do you want task activation from unsolicited interrupts 


This option permits the ICS/ICR driver to initiate a task 
when the driver receives unsolicited input. The option 
provides support for tasks to link to interrupts and obtain 
activation data upon initiation. 


IC controller 0 vector address 


The standard vector address for the ICS/ICR subsystem is 234. 
Enter a value within the range 234-774, Subsequent IC 
controllers obtain vector assignments from floating vector 
Space starting at 300. Consult Field Service if the vector 
addresses are unknown. 


CSR address 


The standard CSR address for the ICS/ICR subsystem is 171776. 
Enter a value within the range 160000-177700. CSR addresses 
for subsequent IC controllers are assigned Starting at 171766 
and proceed downward in eight byte intervals (for example, 
171766, 171756, and 171746). 


Is it an ICR-1l 


Specify whether the subsystem is an ICR-l1l or an ICS-1l. 
SYSGEN repeats this query for each IC controller specified. 


Number of A/D converter modules in this ICS/ICR 


The ICS/ICR subsystem supports up to 16 analog to digital 
converter modules, each with 8 channels. Enter a value in 
the range 0-16. If you enter a non-zero value, SYSGEN asks 
question 7. SYSGEN repeats this question and, if applicable, 
question 7, for each IC controller specified. 


a ee a 


7, 


*8, 


The ICS/I 
e D 
e §S 
e B 
e D 
e D 
e Tf 
SYSGEN pr 
questions 
(in quest 
*12. 
*13. 
*14, 
*15. 
*16. 
*17. 
*9, 


*10. 


*1ll. 
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A/D converter module number 
Enter the module number in the range 0-15. 
Number of expansion multiplexers 
Enter a value in the range 0-7. 
CR subsystem consists of six distinct modules: 
7A converter 
ingle-shot output 
i-stable output 
igital sense 
igital interrupt 
/O counter 
ompts for the number of each module in your system (in 
12 through 17) and then asks for the module number of each 
ion 9). 
Number of D/A converter modules in this ICS/ICR 
Number of single-shot output modules in this ICS/ICR 
Number of bi-stable output modules in this ICS/ICR 
Number of digital sense modules in this ICS/ICR 
Number of digital interrupt modules in this ICS/ICR 
Number of 1/0 counter modules in this ICS/ICR 
(module name) module number 
This question appears for each module you include (specify a 
non-zero number of modules). Enter a value in the range 
0-15. 
Restore module status on power and error recovery 
This question appears only if the system includes a bi-stable 
output, D/A converter, or I/O counter module (non-zero 
response to questions 14, 12, or 17 respectively). 
If you select this option, the ICS/ICR driver restores’ the 
state of all bi-stable digital outputs, analog outputs, and 
I/O prescalar values on power recovery and recovery from 
Sustained serial transmission errors. 


How many line errors are acceptable per second 


This question appears only if you include the restore module 
status option (respond Yes to question 10). 


When serial line errors exceed the limit you specify in 
response to this question, the IC driver places the affected 
subsystem offline (when the line errors cease, the driver 
automatically places the subsystem online). Enter a value in 
the range 0-5000. 


*18, 


*19, 


*20. 


*21, 


*22, 


*23. 


*24, 


*25. 


*26. 
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Expanded comments for DSS/DRS questions 


Expanded comments provide explanatory text that helps you 
answer the DSS/DRS questions. 


Number of DRS-11 modules 

Enter the number of DRS-11 digital output modules in the 
range 0-16. If you enter 0, SYSGEN omits questions 20, 21, 
and 22. 

Restore module status on power and error recovery 

If you select this option, the DRS driver restores the state 
of all 48 buffered digital output modules on power recovery 
and recovery from sustained transmission errors. 

DRS-11 CSR address 

Enter a value for the CSR address in the range 160000-177700. 
DRS-11 vector address 

Enter a value for the vector address in the range 300-774. 
Number of DSS-11 digital input modules 

Enter the number of DSS-11 digital input modules. Note that 
the total number of DRS-11 and DSS-11 modules cannot exceed 
16. Thus, the acceptable range for this response is 0 to 16 
minus the number of DRS-11 modules specified in question 19. 
If you enter 0, SYSGEN omits questions 24, 25, and 26. 

DSS-11 CSR address 

Enter a value for the CSR address in the range 160000-177700. 
DSS-11 vector address 

Enter a value for the vector address in the range 300-774. 
Task activation from unsolicited interrupts 

This option permits the DSS/DRS driver to initiate a task 
when the driver receives unsolicited input, The option 


provides support for tasks to link to interrupts and obtain 
activation data upon initiation. 


If your system includes IP11/1IP300 Support, SYSGEN asks the following 
questions. Consult the IP11/IP300 documentation for details on the 
IP11/IP300 I/O subsystem. 


*#1, 


*2. 


Extended comments for IP11/IP300 


Expanded comments provide explanatory text that helps you 
answer the IP11/IP300 questions, 


Treat all controllers as one unit 


If you respond Yes, SYSGEN generates one SCB and one UCB. to 
cover all IP1l1 controllers. This creates the appearance of a 
Single, large IP11l controller with all of the I/O modules 
connected to it. This option results in a loss of system 
efficiency and also decreases the total number of A/D 
converters to sixteen. 


*3. 


A, 
*S. 


*6. 
*7. 
*8, 
*9, 
*10. 


DETAILS OF SYSGEN PHASE I 


If you respond No, SYSGEN generates one SCB and one UCB for 
each IP11 controllers. Each controller must then be 
referenced with a different LUN. If you enter No, each 
controller can support sixteen A/D converters, but’ the 
programmer must know which controller a particular I/O module 
is on as well as the module index. 


For example, consider a PDP-11 that has two IP11 controllers. 
Controller No. 0 has one M6011 digital output module (16 
points) and eight A014 A/D converter modules. Controller No. 
1 has two M6011 modules (32 points), one M5010 digital input 
module (32 points), and three A014 modules. If all 
controllers are treated as one unit (Y to the above 
question), the driver will cause the system to respond as if 
there were only one controller with 48 digital output points 
(M6011), 32 digital input points (M5010), and eleven A/D 
converter modules (A014). 


Any latching digital output modules 


Because the IP11/IP300 device driver determines the system 
configuration at bootstrap or power-up time, it is not 
necessary to specify how many of each type of module are 
present. You are asked whether you have (or will ever have) 
each module type so that the code to support unused modules 
will not be assembled. 


Any single-shot output modules 

Direct output via QIO 

This option allows a task to output to digital or single-shot 
output modules without overmapping the I/O page. The option 
Simplifies task code, but increases overhead. 

Note that the direct output via QIO support is not required 
in order for FORTRAN support to work. However, if present, 
it will not interfere with FORTRAN support. 

The question appears only if you include a latching digital 
output module or a single-shot output module (Yes response to 
question 3 or 4). 

Any non-interrupting digital sense modules 

Any interrupting digital sense modules 

Any change-of~state modules 

Any counter modules 

Direct input via QIO 

This option allows a task to perform digital input with a QIO 
directive rather than by mapping over the I/O page. The 
option simplifies task code, but increases overhead. 

Note that direct input via QIO is not required for FORTRAN 
support to work. However, if present, it will not interfere 


with FORTRAN support. 


This question appears only if you responded Yes to one or 
more of questions 6, 7, 8, or 9. 


*11, 


*12. 


*13. 
*14, 
*15. 


*16. 


*17. 


*18. 
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Unsolicited interrupt support 


The M5011, M5012, and M5013 interrupting modules can produce 
unsolicited interrupts when certain input bits change state. 
I£ you select this option, the interrupts can be monitored by 
a task. 


This question appears only if you responded Yes to question 7 
or 8. 


Event flag linkage to interrupts 


A task can monitor digital interrupts by linking a contiguous 
group of event flags to interrupting bits. If you select 
this option, the driver sets the corresponding event flag 
whenever its associated bit causes an interrupt. 


Any D/A converters 

Any A014 A/D converters 

Any A020 A/D converters 

How many output bytes should be saved on powerfail 


The answer to this query reserves table space in the 
IP11/IP300 driver. If the answer to the query is n, 4*n 
bytes are reserved. This space is part of the Executive, so 
available pool space is correspondingly decreased. 


At powerfail time, if there is not enough space in the table 
to save all outputs, the excess outputs will be lost and will 
not be restored. 


This question appears only if the system includes one or more 
output modules and you included Executive support for power 
fail recovery. Output modules are the M6010, M6012, and 
M6013 Latching Digital Output modules; the M6011 Single-Shot 
Output module; and the A630 D/A Converter module. 


The acceptable range is 0-3048(10). 
Enter 0 (or carriage return) to disable output restoration. 
IP1l1 vector 


Enter the interrupt vector address for the first IPll 
controller. The standard vector address, and the default 
value, is 234. I£ you do not use the default assignment, the 
acceptable range is 60-774. Subsequent IP11 controllers are 
assigned vector addresses from floating vector space and 
there is no default. Enter a value within the acceptable 
range. Consult Field Service if the IPll vector address is 
unknown. 


Base address 


Note that this question requests the IPll base address and 


not the CSR address. The base address is the CSR address 
minus 377 octal. 


For the first IP11l controller, the default base address is 


171000. For the second IP1l controller, the default base 
address is 171400. 
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The acceptable range for the IPll base address is 
160000-177400. 


The third and subsequent IP11 controllers are assigned base 
addresses from floating address space and do not have default 
responses. Enter a value within the acceptable range. 


Consult Field Service if the IP11 base address is unknown. 


5.7 DETAILS OF SYSGEN PROCESSING 


During a system generation, SYSGEN issues command lines and displays 
comment lines. This section uses a console listing from an actual 
system generation to detail and describe the command lines as well as 
interpret the more obscure comment lines. 


The console listing appears below. It is followed by notes which are 
keyed to the listing. 
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RSX“11M V3.2 BLAS 2BK 
TH. 3s 
Dts M1) 
OU TLS RSEXMed 

Le tiy 20STARTUF 

BE ENTER TIME ANI TATE CHREMN DNI-MMM-YY) ESE 72 


INS $800 
SROO DLitis 844 2) 


RSX-11M V3.2 B24 64k MAREN 
RED In. te€ 
RET Th 
=MOU D.. 


: 3 TIME AND DATE CHRIMN I-MMM-YY) [CSIL 12t00 23-May-79 
“TIM 12100, “93- “MAY: “79 
: iN WEOTH OF THIS TERMINAL CY 8132.03 


oY 

7 NOTE ~ The Baseline INItirect must be rerlaceac ty BIGING with 
ra] a rriorityu of 16. for Sys N. 

oy 

Foie eee AT, 

ns SINS $BIGINU/PRI@LO, 

oe 


28 EOFS 

“REM eee ATs 
SINS $BIGIND/FRI 
TNS -~ WARNING ~ TLEGED TASK OVERMAPS 1/70 PAGE 3) 
SING  $RLGL 80000 

INS -- PARTITION PARLA4K NOT IN SYSTEM, DEFAULTING TO GEN 
“ASN TLe=syt 

“@3YSGEN 


: RSX-1iM Version 3.2 BL2é Sustem Generation 3.2.2c done on 2a-MAY-79 at 
» Ginerisnt (Cl) 1979 Visitel Eauiement Coreorations Maynard Mase. 

: RLOL distribution kit 

> le Inhibit MCR command Lines (Ture for RA eta EY/NAS 


2» Have vou made a cory af the ibution bi: 
- : saved or canned answer file for ireut ce Moneece CY/NI3 
f et ii SSAVEM. UAT? CY/NITLY 

ret 20072007 Sis 
for SY§ nat [200792007 ES 
Dlearn ur files from eravious GENS? CY/NIt 
14. Yievices when reacdsuy for & cutive gourees Cecut) SU tha 


for SYSSe 


“ 
a] 
; 
ng 
*§ 
F 
OK 
ok 
OK 
KY 
ok oy 
SK 
2K | 
ok 
oF 
> 


DLO? HAS BLOCKS 


ASUS BLOCKS USED OUT OF 10240, 
LARGEST CONTIGUOUS 


BLOCKS 


" /UICe Le Loo 


ah confisuratior 


Le Free C@stet 
3. Gene res 
Mere rig 
wie Maz 
4. Aree | 


IS Rise4603 21770 


CD Re Been LP20.72 S12 


Beek ea cd 
> 
: 


aratory devimes? CY“NGt 


12301 


+ 


weg ue ag ar A we 


SE 3G vee wee ee wes e958 56 EE EE EE EH Hw HK 


ag 


apa ue ot i ow et Le © 


“ 


pug 


wey 


we 


wT A OY 
we HE 


ee a 
wf wf we ooh 


Reo 


3M MH we ee wr 


wets 


fou te} 
oe 


BR KRM KK RK KEKE KRKN GOO KRKKK RUS 


Leap ig ke te 


Les 
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Floating roaint erocessor CFP-11) rrasent? CY/NITY 

tf usine KWit-F as sustem clock! rumber of intres.,/sec. CO RtO.-1000.13 
Line freauercyt A- 60 Hz Ee SO Mx Cos "A" C87 

KWiieY Watehdos timer suerort? EY/NT3 

Memory rarity gurrort? CY/NILY 

Cache memaru? CY/NILY 

Highest interruret veetor CIF O will be computed) CO Rt0O-7741% 

For device configuration? "*" Prints device table, ‘." Terminates inauiry 
Enter devices and runber of controllers for devices which reauire drivers 
Yevices CSI? Ik 

Yevieces [S37 DK 

Nevieas CS7i 0S 

Nevi CS TM 

Teviees [Sat Tx 

Yeviees TS TT 

Nav cSt MM 

Coie oT 

Nervi CS: Tt 

evi ESis LF 

Neviees ESdt . 


Froceagsoart Li 770 Memory SiszetSleksMarred Sus temthSx-LiM 


Hogskh configuration 


EOS 


Are vou rindi SYSGEN standalone Corn the baseline system)? CY/NISY 
is @ line erinter available? CY/NA$ 

Noes ad/mar device have at least 120 columns? CY/NISY 

5 device Cdeut>) CUE "NLt"a CSae 

Executive and deviow drivers Cdedut>d) Cos Syt7 (S43 


x Da vou wank tot <CRe-contirue Rerereat section E-exit Peeause [SI]: 


Executive Ortiors 


Answer YCES) if the followings surrort is desired 


Will UEMS=1. be used? CY/NITE 

FILES<11 ACK P LY/NISY 

RMS record locking anc elacement corrkrol? CY/NILY 
i ‘ (task Lloacderd? LY/NIULY 

Loowclain wack Loader? CY/NILY 

Memory mare ment (PLAS)? directives? CY/NITY 
Send/Receive by reference directives? EY/NILY 

Get mi E 


ae erobtection? CY/NILY 
tare ACEP CYZNILY 
formatting (FMT) or on<ling sser-mode diasnostics? CY/NALY 
Lcnaeed davice drivers? CY/NITY 
Showld the default for all aeelicable drivers be loadable? CY/NILY 
AST surrort wild be ime dude 
ranee), sel Jive MARKTIM 
ation and device mot ready megs 
sooverg? CYZNISY m 
rec ty and remove om exit? LY/NIUTY 
CROOK) Exe CY/NU2Y 
davice sistimerct? CYANITLY 
rrars and Gimeoute? CY/NATY 

f CY/NIALY 
EY/NIALY 
inelude a ugere-writben driver? CY/NTE 
CY/NIAGY 


uerort willl be dine huded 
aH CTRTND? CY/NIGY 


of 
at 
No vou dint 
t . writect 


erint erooler? LY/NUGY 


RY/ZNIY 


a, 


oF 
DK 
aK 
wk 
nx 
ok 
Xk 
nok 
2K 
2K 
ik 
OK 
Kk 
2K 
cK 


*% 


ae oy 


faurhe ts ue te 


wah ode BE: 5 SESE: oii BEE Se Ss 


ok 


Meh ee ED eo ey “E> OSS ee cee EE ME Mae Ces ee Mae en ce ee ED en cee en 5 er 
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For directives? "X" Prints tabler "." Terminates inauirgy 
34. Enter cade for directives [S43 %, 
35. Number of ere-allocated Q10 rackets CO R1O.-15., Of5.0 
BGe 2 Of data transfer vector in words [CO RIS.-33,. 0233.74 
37. Round-rotare sehecthol iris 
40, E tive level cisk swe 
41. 8 ing priority Cl Rid. -20. W95.7% 
42. Si 
43. Ge 
45. 


ivrinber mot ready messases CO RIO.-255. It 


A? § ; 
48. Disine ria Live 
49. Quteutk motifs 
SO. Memory cume device Codd) CS RtSe472 DKO 

Uil+ CSR address of dume device CO R$£160000-177700 0117740413 


A~ PANIC B- Crash (CIA) 


Terminal driver orbions 
1. Terminal driver desired (A/B/C/Ily xX erints table) CS A 
Answer YCES) if the following gurrort is desi rec 


trectiy to terminal? CY/NITLY 

return/Lline feed? CY/NILY 

z a during terminal imput? CY/NILY 

ut character AST? CY/NITY 
cellation? EY/NA 

“guerort will be inmeludad 

be ine duded 

PORY/NAUS 

stics? CY/NILY 

eharacte ies? CY/NIAGY 

iriver ortions? LY/NILY 

14. Horde screen mode? TY/NIVY 
# rt d/utite sureort will be included 


anghat 


! rarversion for input? CY/NATY 
r e rome? RY/NT 
with no echo surreort will be inmeluded 
sh with seecial terminator surreort will be included 
20+ CRT rubouwt guereorbh?e EY/ZNILY 
Terminal “host Benen rota tion? EY/NAGY 
FE a? LY/NILY 
newt butterins? CY/NI¢ 


® length termine 
Axor sureorh? CYNE 


interval in ticks [CO RtO.~1000. [35.79 
ing interval CO RL1O.-GO00. D230, . 


*%" Gets all 


td) 


daunamic gbhorade resion (FOOL) in words CO RI256.-16384. [1024.3% 
30.13 255 

‘ sh resigter and stack dumre device CSR CO RiO0-177700 013177546433 
46. Checkerodintairst Aan Yas BR- With system ckrmt. 


file CSit B 


entrled rartitiongst Ay Yes 9 Ee With auto comeaction (SHF) ESIt 


CSii &B 


rLion device CSR CO Rt140000-177700 N17756418 


177400 


EOS * Do gow wank tab <Cko-corbinwe Rerereat section E-exit Perause CS7t 


Ttrdimik drs see 
End of Executive oetion generation at L2t12t49 on 23-MAY<79 
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lier of & fartiewlar 
“Coeed® 


eregent oor the 


Larseat, 


Tire ae 
Ta overricde 
for the. 


drivers 
~ KR Cregic 
cantroaller aot 


to 


Pied 
4/7) and Laboratory daviecess None srecifiad 
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Unit reeard ceavie@s: LF 
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KTRUEXK, 


Piet raranater 
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Enter EL/Re ld vectors CSRy erinter ture 
CoLKMC timeout count <O=na KMCes KMG vectors KMC CSR) for’ 


a 


16. LF controller O EE 2002177914 9LA1G0702 500714601307 CSIt VL 773N3N510rLP11-C 


fw 


ME 
JE JE a> en en an er ee FE “E> > o> 


Viske! DBy Dk, Gly [My US DT, DX 


og Enter CL/Rri vectors CSR» rumber of drivesr unit rumber of first drives 
= COzoffset recovers surrort/NOeno suprort) fort 

” 2, D8 controller 0 EUS 25471767002 7070] CSS v4 

“ek 52, Contr O unit O-. is an RPO4,05/RPO6 CI REPOST CST 

“k 52, Contr O urndt 1. is an RPO4sOS/RFOS6 CUE RFOSI CSI% 


59, Contr O unit 2. is an RFO4,05/RFO6 CONF RFOSI CS$1t RFOS 
59, Contr O unit 3+ is an RPO4,OS/RFOS Clk RPOSI CS1t RFO4 


ae ue at hs 
“f aes 


Enter CL/Ryd vector: CSRy hidhest unit mumber <0 to 7s fort 


ye 
“e 


nw Ww 
3G we a> er 36 3 


6 DK controller O [Ut 220°177404] UHIt 217740093 


wow 


Enter CL/ZR»] veotorsy CSR» rmumber of drives fort 


wi 


3. DL controller O Cis 1609174400] CSI1t v17752072 
S3, Contr O unit O-. is am RLOL/RLO2 Cis ROL CS 
53, Contr O unit t. is am RLOI/RLOZ CU3 RLOL {Sai 


Enter CL/Red vectors CSKy # drives: OQeoffset recovery/NO=no offset rec. for$ 


ayo ww 


HHO ww HH HO ww 


af 


13. OM controller 0 Cis 2109177440970) CSIt v2 
SA, Contr O unit O. is am RKOS/RKO7 C3 RROGI C343 
54. Contr O unit 1. is am RKOS/RKO7 Cot RKO6I Cs 


Enter CL/Ry] vectory CSRy rumber of drives, writ number of first drive for’ 


wv WY 


5. 08 controller 0 EME 2047172040770) CS13 217209092 
SGN -- Lllesal character in rumeric resronse -~ RETRY 
%, DS controller O EUt 2049172040770] CSAt x2 
57, Contr O unit O- is am RSO3Z/RS04 C3 S04) CSae 
57, Contr O unit 1d. is am RGOZ/RSO4 CUt RSO4] ESat 


ag a 


ap oe 


wer ce <> OG “er 9G O eo a> 36 9G FE OP Ee ee 


Enter CL/Ryd veetors CSR» rumber of drives for? 


bree 


sy 


%,. TT controller O Lt 2149177342) {S12 2177340r2 


ae ue 


3, 0X controller O CM 26421771704 USI? re92 


gouge ag 


Tareat MM 


Enter (Ci/Re ld vector, CSRy ramber of drives fort 


* 3B. MM combroller O RU? 2249172440) CSU v2 

“* Sle MM controller O urit O.« Formatter C0 RiOe7 TEOTS 

=k Fl. MM controller O unit Le formatter C0 RiOe7 EON 

“$ Nonerhusieal Crseuda) cdevicest CO» The Thy Chy Ly SY 

‘oe Erber Ch/RyD raime Us SZ rime THAD se rime UZLa’ sr cums. W's Port 
“Kx 19. The terminal driver COE TeOrOv0d US1t 93 


Enter vectors CSR fort 
et, ZL cantrollear O LM3 60917754607 badd 


| line number =O to Loo 
sly IML Le veetory DML tia CORD for? 


Enter veetory COR» hish 
Cranswar 


SIO e LGOORO y LS yy 3O0r 170500 
3207160040" 15 


RV ee a ne ee 


22, DH controller Of 
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Id vey SOOO OT 
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ok 22. DH controller 2 COU? 293007070] CSI3 330716006095 
oF 
7k EQS * [lo you want tot <CR>-comtinue R-rereat section E-exit Ferause (S13 
id 
eo End of interruet vector area has heen set to 400 
oF 
29 
=) Create Executive build files 
ea 
oPIF RSXMC.MAC#LESRSXMCO.MAC/AF @ 3 
oF 
>9 Assemble the Executive 
*S 
“PIP Ciis24/NV=RSXASM,. CMI y RSXDRVASM. CMI © 
>PIF RSXASM. CMI O/DE rs RSXDRVASM EO 
SREM FIF ” 
oF 
7K 1. Do vou wish ta edit any of the Executive files? CY/NI? 
ee 
mF 
7k EOS * To vou want tot <CR>-continue Rereareat section E~exit P-pause CS1? 
%$SET /COFFEEBREAK=TLt Start of Executive assembly at 12331145 om 23-MAY~-79 7) 
SSET /UIC@#L119247 
oMAC @RSXASM 
>FSET /NOCOFFEEBREAK=TIt Executive assembly ended at 12256336 on 23-MAY~-79 rN 
oF = 
7% EOX x Did the Executive assemble correctly? CY/NITY 
oF 
-§SET /COFFEEBREAK=TI$ Start of device drivers assembly at 12$546145 on 23-mMay-79@ 
SSET /ULC#0119247 
>MAC @RSXIRVASM 
S9SET /NOCOFFEEBREAK#TL? Device drivers assembly ended at 13:03355 on 23-MAY~-79 
75 
“* EOX * Tid the device drivers assemble correctly? CY/NILY 
oS 
iF 
*% FPrerare for task tudldins 
Ra ee 
SINS SYISPIF 
SPIF RSX .O8S=*,ORJ 
SPIF X.OBI9 K/DE/NM 
cP TP REXLIM. ORJ/RESRSX. ORS 9) 
eSET /ULC=f12247 
PTR /NVeEl lis LOURSXBLO. OMI 
eREM PIE 
ye 
ok EOS * Do vou want tot <CRe-cantinwe Re-rereat section F-rause CS7t 
co 
ca 
oo Ere of SYSGEN rhage Eo at 13f08t54 on 23—MAY-79 ts, 
oe ~~ To continue tures @L200,20071SYSGEN2 iat 
eg pe 
SSET /UTC# L200 2007 
2@ EOF 
> 


Notes: 


@ 
3 ] 
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This is the display from the hardware boot of the {1,50] 
unmapped system prior to SYSGEN. 


This is the software boot of the [1,54] mapped system. 


Preparing for SYSGEN; remove the 8K-word indirect, install 
BIGIND (priority of 10 permits other tasks, for example PIP, 
to checkpoint AT.), install BIGMAC (increment of 50000 speeds 
MACRO-11 assembly operations), assign the baseline system 
disk to the pseudo device SY:, and initiate SYSGEN. 


Distribution kit variance. If you are performing a SYSGEN 
using the dual RKOS5S kit or the RLO1 kit, SYSGEN mounts and 
assigns the source disk to LB:. If you are performing a 
PREPGEN, you must mount and assign the source disk to LB:. 


Big disk distribution kits contain the source files; the 
commands are omitted. 


SYSGEN then installs PIP and displays the number of free disk 
blocks. 


PIP command to append temporary file to the assembly prefix 
file. RSXMC.MAC now contains Executive options and 
peripheral components. 


PIP command to copy Executive and device drivers assembly 
command files from [11,10] to [11,24]. SYSGEN then issues a 
PIP command to delete the assembly command files from {11,10] 
and removes PIP. 


At this point, SYSGEN is ready to assemble the Executive. 
Depending on the host processor and the options you selected, 
Executive assembly takes anywhere from 20 minutes to 2 hours. 
You have two options: 


A) Go have some coffee (note that if you responded B_ to 
target question 11, you will probably have some tea). 


B) Read on for methods of correcting DSR space problems 
and some space saving tips. 
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If you select A, go have some coffee and read the description 
following note number 8. ; 


If you select B, read the following. 


During the running of RSX-11M, it is possible to exhaust 
dynamic memory. This can occur if a large number of tasks 
are installed, if many volumes are mounted, of if a number of 
other conditions are present. When you exhaust dynamic 
memory space, the problem manifests itself in the lack of 
response from the system. Although the system looks like it 
is operating successfully, it cannot accept any MCR commands 
or complete execution of presently running tasks because they 
all require dynamic memory. 


Another manifestation of the problem may be I/O errors’ being 
received by tasks or failures in the Loader due to pool 
allocation failures. The only solution to this problem is to 
bootstrap the system and make more dynamic space available 
(SET /POOL), remove tasks, mount fewer volumes, rebuild FCP 
with space for more file control blocks in its partition, or 
rebuild the system with more dynamic memory. 


The following lists potential methods of saving dynamic 
memory space. 


By including the install, request, and remove on exit 
capability into a generated system, considerable dynamic 
memory may be saved for tasks that are initiated from a 
terminal. The MCR RUN command will install the tasks when 
needed and cause them to be removed when they exit (see the 
RSX-11M/M-PLUS MCR Operations Manual). Thus, task control 
blocks need not be permanently allocated. Typical tasks in 
this category are the program development and utility tasks 
provided with the RSX-11M system, (PIP, MAC, TKB, etc.). 


The use of checkpointing and nonresident tasks, where 
appropriate, can reduce the number of tasks that are 
simultaneously in memory. This saves space in a mapped 
system, since fewer task headers need to be copied. 


The file system ACP (F11ACP) may be built to store File 
Control blocks in its own task image rather than in the 
dynamic storage region. The more space allocated at task 
build time the less the demand will be on the pool. However, 
if the allocated space becomes used up, the overflow will use 
the dynamic storage region. 


The directory least-recently-used table default is three 
18-word file control blocks. The effect of this table is a 
significant increase in the speed of directory operations. 
If this level of performance is not required, a volume May be 
mounted using the /LRU keyword, thereby reducing the number 
of FCBs- used. See the description of the Mount command in 


the RSX-11M/M-PLUS MCR Operations Manual. 


Now go have some coffee; SYSGEN is ready to assemble the 
device drivers. When you return, read the description 
following note number 9. 


ta 
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© At this point, SYSGEN is ready to assemble the device 


drivers. Read the following for the methods of correcting 
DSR space problems and some space saving tips. 


During the running of RSX-11M, it is possible to exhaust 
dynamic memory. This can occur if a large number of tasks 
are installed, if many volumes are mounted, or if a number of 
other conditions are present. When you exhaust dynamic 
memory space, the problem manifests itself in the lack of 
response from the system. Although the system looks like it 
is operating successfully, it cannot accept any MCR commands 
or complete execution of presently running tasks because they 
all require dynamic memory. 


Another manifestation of the problem may be I/O errors being 
received by tasks or failures in the Loader due to pool 
allocation failures. The only solution to this problem is to 
bootstrap the system and make more dynamic space available 
(SET /POOL), remove tasks, mount fewer volumes, rebuild FCP 
with space for more file control blocks in its partition, or 
rebuild the system with more dynamic memory. 


The following lists potential methods of saving dynamic 
memory space. 


By including the install, request, and remove on exit 
capability into a generated system, considerable dynamic 
memory may be saved for tasks that are initiated from a 
terminal. The MCR RUN command will install the tasks when 
needed and cause them to be removed when they exit (see the 
RSX-11M/M-PLUS MCR __O erations Manual). Thus, task control 
blocks need not be permanently allocated. Typical tasks in 
this category are the program development and utility tasks 
provided with the RSX-11M system, (PIP, MAC, TKB, etc.). 


The use of checkpointing and nonresident tasks, where 
appropriate, can reduce the number of tasks that are 
simultaneously in memory. This saves space in a mapped 
system, since fewer task headers need to be copied. 


The file system ACP (Fl1ACP) may be built to store File 
Control blocks in its own task image rather than in the 
dynamic storage region. The more space allocated at task 
build time the less the demand will be on the pool. However, 
if the allocated space becomes used up, the overflow will use 
the dynamic storage region. 


The directory least-recently-used table default is three 
18-word file control blocks. The effect of this table is a 
significant increase in the speed of directory operations. 
If this level of performance is not required, a volume may be 
mounted using the /LRU keyword, thereby reducing the number 
of FCBs used. 


Now read the description following note number 9. 
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© At this point, SYSGEN has assembled the Executive and all 


selected device drivers. You have had some coffee (or tea) 
and read some tips on conserving DSR space. SYSGEN ihstalls 
PIP to concatenate all existing object files cataloged under 
the UFD [11,24] into a file RSX.OBS. PIP then deletes all 
-OBJ files and renames RSX.OBS to RSX11M.0BJ if you are 
generating an RSX-11M system or to RSX11S.0BJ if you are 
generating an RSX-11S system. 


SYSGEN then changes the UIC and creates a new version of the 


build command file in [1,24] for mapped systems or [1,20] for 
unmapped systems. 


You are now ready to start SYSGEN Phase II and task build the 
Executive and device drivers. 


CHAPTER 6 


SUMMARY OF SYSGEN PHASE II QUESTIONS 


SYSGEN Phase II is controlled by the command file SYSGEN2.CMD. 
Initiate Phase II by typing 


>@SYSGEN2 


This chapter provides a summary of Phase II. Read Chapter 7 for 
complete details. 


6.1 SUMMARY OF SYSGEN PHASE II QUESTIONS 
1. In what UIC is SGNPARM.CMD if not [current UIC] 
Enter a UIC to override the default specified in Phase I. 
2. Expanded comments desired for SYSGEN Phase II 
Enter Yes for instructions during Phase II processing. 
3. Is SYSGEN still running online 
Enter Yes if performing an online SYSGEN. 
4. Is SYSGEN still running standalone 
Enter Yes if performing SYSGEN standalone. 
5. If not in dev enter object files device when ready (ddu:) 


Enter the device that contains object files (default is 
device specified in Phase I). 


6. Have you already built the libraries, the Exec, and the loadable drivers 


Enter Yes to skip Executive build and start privileged task 
build. 


7. Delete (uic) to insure enough space for SYSGEN Phase II 


Enter Yes to delete mapped system if running unmapped or _ to 
delete unmapped system if running mapped. See Chapter 7. 


8. Create ANSLIB to support Big-buffering 


Enter Yes to create ANSLIB as if ANSI magtape support was not 
included, 
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9. Add the lab device's Purdue ISA routines to library 


Enter Yes to include Purdue ISA routines for IC:, IS:, UD:, 
AR:, or LS: devices. 


10. List Executive map 
Enter Yes to print map of Executive global symbols. 

11, FCP desired (Type <ESC> for explanation) [D:MIDDLE] 
Enter the FCP you wish to include in your system. For mapped 
systems, enter NON-MULTIHEADER, SMALL, MIDDLE, LARGE, PLAS, 
or OTHER. For unmapped systems, enter NON~MULTIHEADER, 
SMALL, MIDDLE, or OTHER. 

12. SYSPAR's base address in 32 word blocks 


Enter the base address of partition SYSPAR. The default is 
300 for systems that include FCPNMH and 301 if not. 


13. Build the unprivileged queue manager utilities 
Enter Yes to build the nonprivileged queue manager utilities. 
14. Build the task PMD 
Enter Yes to build the Post Mortem Dump task. 
15. Build RMDEMO 
Enter Yes to build the system display task RMDEMO. 
16. Build the non-queuve manager print spooler 
Enter Yes to build the serial despooler. 
17. Edit any privileged task build files 


Enter Yes to change partition statements for the privileged 
tasks. 


18. Map device for privileged tasks (ddu:) [D:NL:] 


These maps are rarely needed. Enter a device specification 
if you want them. 


19. Edit SYSVMR.CMD 


Enter Yes if you are generating an unmapped system. If you 
are generating a mapped system, SYSVMR.CMD typically produces 
a valid system image. See Chapter 7. 


6.2 SUMMARY OF LOADABLE DRIVER BUILD PHASE 


The file SGNBLDDRV.CMD controls task builder processing of loadable 
drivers and user-written drivers. 


During Phase II, SYSGEN calls this file to build loadable or 
user-written drivers. However, you can initiate SGNBLDDRV.CMD as a 
command file. If you initiate SGNBLDDRV.CMD, you must answer 
questions 1-5; if SYSGEN calls the file, these parameters are known. 


10. 


ll. 


12. 
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Are you building drivers for a mapped system 

Does your system include any user written drivers 

Are you building drivers for an RSX-11S system 

Does. your system include the KMC-LP driver 

Does your system have the full duplex terminal driver 
Device for driver's maps 


Enter a device specification for the task builder maps of the 
drivers. 


Spool maps 

Enter Yes if you want the maps spooled. 

Does the map device have at least 120 columns 
Enter Yes for wide maps, No for narrow format maps. 
Build all selected loadable drivers into DRVPAR 


Enter Yes to build all the drivers you selected for the 
system-controlled partition DRVPAR. 


Driver 2-character device mnemonic 


Enter the 2-character device mnemonic for each loadable 
driver you want to build. 


Driver partition name 

Enter the partition name for each driver specified in 
question 10. (Default for mapped systems is DRVPAR. Default 
for unmapped systems is devPAR where dev corresponds to the 
2-character device mnemonic specified in question 10.) 


devPAR's partition base address 


Enter the base address of the specified partition. 


CHAPTER 7 


DETAILS OF SYSGEN PHASE II 


Input to SYSGEN Phase II consists of object and build files from 
SYSGEN Phase I. Phase II builds the user-tailored Executive, 
privileged tasks and, if selected, the loadable device drivers. At 
the completion of the task builder processing, SYSGEN Phase II 
attempts to define memory partitions and installs the system image on 
the target volume using the Virtual Monitor Console Routine (VMR). 


SYSGEN Phase II requires four files: RSXBLD.CMD, RSX11M.0BJ, 
SGNPARM.CMD and optionally, TTDRVBLD.CMD for the full duplex terminal 
driver. These files must exist on the system disk. In addition, the 
files for the UDC, DRS/DSS11, or ICS/ICR-11 common blocks must also 
reside on the system disk if user tasks are going to access the device 
registers, 


The file RSXBLD.CMD directs the Task Builder in constructing the 
user-tailored Executive. SYSGEN Phase I creates this file based on 
your responses. 


The file RSX11M.0BJ is the concatenated object module file produced by 
PIP from the user-tailored Executive object modules following the 
assembly operation in Phase I. 


The file SGNPARM.CMD serves as input to Phase II. This file insures 
that Phase II processing is compatible with the responses from Phase 
I. 


The file TTDRVBLD.CMD directs the Task Builder in constructing the 
full duplex terminal driver. SYSGEN Phase I creates this file when 
you select the full duplex terminal driver. 


Figure 7-1 shows the processing steps that take place during SYSGEN 
Phase II. 
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Target Volume Processor Memory 


RSX11M.SYS 


5. Boot your system. 


Figure 7-1 SYSGEN Phase II Processing Steps 


CAUTION 


It is likely that you will exhaust RLO1 
disk space on the mapped (MAPSRC) or 
unmapped (UNMSRC) source disk. This 
prevents successful completion of SYSGEN 
Phase II. Therefore, it is recommended 
that RLO1 kit users delete unused driver 
source files (for devices not included 
in the system) from [11,10] before 
beginning SYSGEN. The following lists 
‘seldom-used devices and thus the driver 
source files. 


" 
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Communication devices: 


PHASE II 


XBDRV.MAC DA11-B UNIBUS link 
XLDRV.MAC DL11-E Serial line 
XPDRV .MAC DPll Synchronous line 
XQDRV.MAC DQ11 Synchronous line 
XUDRV .MAC DU11 Synchronous line 
XWDRV .MAC DUP11 Synchronous line 


Process I/0 


and Laboratory devices: 


ICDRV ..MAC IcS/ICR11 Subsystems 

IPDRV .MAC IP11/IP300 Subsystems 

ISDRV.MAC DRS/DSS11 Subsystems 

UDDRV .MAC uDCl1l Subsystems 

LSDRV.MAC. LPS1ll Laboratory system 
LADRV .MAC LPA11 Laboratory accelerator 
ARDRV .MAC AR11 Analog module 
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1. In what UIC is SGNPARM.CMD if not [current uic] 


The file SGNPARM.CMD contains the parameters from Phase 


I that 


are necessary in Phase II. SYSGEN Phase I creates this file in 
the UFD corresponding to the default UIC specified in Phase I. 
Enter a UIC to override the default. 

2. Expanded comments desired for SYSGEN Phase II 
Enter Yes if you are unfamiliar with SYSGEN processing; comments 
provide instructions during Phase II processing. 

3. Is SYSGEN still running online 
This question appears only if you responded No to Host question 


1. In Phase I, you specified that you were performing an online 


SYSGEN. 


4. Is SYSGEN still running stand-alone 


Enter Yes if that remains true. 


This question appears only if you responded Yes to Host 


question 


l. In Phase I, you specified that you were performing a SYSGEN 
using the baseline system. Enter Yes if that remains true. 


5. If not in dev enter object files device when ready (ddu:) 


This question appears only if you are using a 
RLO1 distribution kit. Enter the device that contains the object 
files. Note that the default device is the device for the source 
files specified in Phase I. Enter a device specification if you 
have moved the disk to another drive. 


dual RKO5 or an 


If you are using a single RLO1 drive 
object files, enter No or None. 


and have not copied the 


6. Have you already built the libraries, the Exec, and the loadable drivers 


Note that SYSGEN truncates this question if you did not select 
loadable driver support; you are not asked whether or not the 
drivers were previously built. 


Vs 


8. 
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This question asks whether or not the Executive has been linked 
together by the Task Builder. SYSGEN Phase I does not link the 
Executive, it only assembles it. Therefore, the first time you 
encounter this question, it should be answered negatively. 


Typically, before a partition can be laid out for unmapped 
systems, the user needs a Task Builder map of the newly built 
user-tailored Executive. This occurs later in SYSGEN2.CMD and 
may require a lengthy off-line analysis of the partition layout 
for the target system. After analyzing the partition layout, 
SYSGEN2.CMD can be re-initiated. If, at this point, an 
affirmative answer is typed, the process of building libraries, 
device drivers and user-tailored Executive is skipped, and 
SYSGEN2.CMD advances to the dialogue to build the privileged 
tasks. 


If you respond Yes to this question, SYSGEN skips questions 7-10. 
Delete (uic) to insure enough space for SYSGEN Phase II 


This question appears only if you are using a dual RKOS5 
distribution kit. 


Disk space on the dual RKO5 kits is critical. To avoid the 
possibility of running out of free disk blocks, you should enter 
Yes to this question (see the Caution below). 


If you are generating an unmapped system and you respond Yes to 
this question, SYSGEN deletes the files for a mapped system (in 
[1,54]) from the baseline system disk (RSXM26). 


If you are generating a mapped system and you respond Yes to this 
question, SYSGEN deletes the files for an unmapped system (in 
{1,50]) from the baseline system disk (RSXM26). 


CAUTION 


If you are generating a mapped system 
using an unmapped system (for example, 
you booted the unmapped baseline system) 
and you delete the unmapped system 
image. You have destroyed your disk. 
You must make another copy of the 
distribution kit and reboot. Likewise 
if you are generating an unmapped system 
using a mapped system image and you 
delete the mapped system. In other 
words, if you are running standalone, do 
not delete the running system image; 
generate an unmapped system using an 
unmapped system image and generate a 
mapped system using a mapped system 
image. 


Create ANSLIB to support Big-buffering 


If you did not select ANSI magtape support in Phase I, this 
question permits you to get big-buffering FCS support. When you 
enter Yes, SYSGEN creates ANSLIB as it would if ANSI magtape 
Support was included. 


) 


Now / 
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Add the lab device's Purdue ISA routines to library 


This question permits you to include the Purdue ISA routines with 
Ic:, IS:, UD:, AR:, or LS: devices. See the appropriate device 
documentation for more information. 


List Executive map 


The Executive map defines the Executive global symbols and _ their 
locations in memory. These locations are used to layout 
partitions. I£ you are generating a large mapped system, the map 
is not necessary. If you are generating an unmapped system, the 
map is required so that you know where to build the drivers. 


I£ you respond Yes, SYSGEN prints or spools the map on the _ line 
printer (if the system includes one) or terminal. 


FCP desired (Type <ESC> for explanation) 


This question appears only if you selected Files-11 support in 
Phase I. 


Mapped RSX-11M systems support five versions of the file system: 
@ 2K-word non-multiheader (disk overlayed) 

@e 2.25K-word multiheader (disk overlayed) 

e 5K-word fast multiheader (disk overlayed) 

e 6.5K-word optimized multiheader (disk overlayed) 

@ 10K-word resident (memory-resident overlayed) 


Unmapped RSX-11M systems support three versions of the file 
system: 


@ 2K-word non-multiheader (disk overlayed) 
e 2.25K-word multiheader (disk overlayed) 
e 5K-word fast multiheader (disk overlayed) 


This question permits you to select the FCP best suited to your 
application needs and memory limits. 


The non-multiheader version (FCPNMH) is the minimum size FI11ACP, 
This FCP restricts files to a maximum of 26,112 blocks of 512 
bytes (no multiheader files) and does not support RMS_~ record 
locking. Use FCPNMH with DECtapes, floppy disks, or with small 
unmapped systems; additional use in a large or multiuser system 
is not recommended. SYSGEN builds FCPNMH to run in partition 
SYSPAR, which is 10000(8) bytes long. For unmapped systems, 
SYSPAR starts at 30100(8). If you want to change partition 
parameters for FCPNMH, you must edit the build command file. 
Enter NON-MULTIHEADER to select this version. (FCPNMH is the 
default for unmapped systems. ) 


The multiheader version (FCPSMO) is a full functionality and 
heavily overlayed FI1ACP. Use FCPSMO with a small memory system. 
Enter SMALL to select this version. 
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The fast multiheader version (FCPMD1) stores as many File Control 
Blocks (FCBs) as possible in its task image before overflowing 
into the dynamic storage region. Use FCPMD1 for applications 
which use the file system in a heavy open/close and read/write 
environment; this version treats file creates, deletes, and 
extends as secondary operations. Enter MIDDLE to select this 
version, (FCPMD1 is the default for mapped systems.) 


The optimized multiheader version (FCPLGl1) is a larger, less 
overlayed F1lACP and is not supported on unmapped systems. This 
version limits disk overlay activity to exception cases and file 
deletions. Use FCPLG1 for development systems and in 
applications which extensively use the file system to create and 
extend files. FCPLG1 is recommended for systems without strict 
memory limitations as well as an alternative to a memory resident 
structure for systems with limited memory. Enter LARGE to select 
this version. 


The resident version (FCPRO2) is supported only on mapped systems 
that include Executive support for memory management directives 
(PLAS). This version eliminates disk overlay activity. Use 
FCPRO2 for development systems and other high performance systems 
that extensively use the file system to manipulate files. Enter 
PLAS to select this version. 


When you select the FCP that best fits your memory limits, you 
can consider Task Builder options that improve FCP performance. 
For all versions except FCPNMH, the distribution kits include 
multiple build command files for the FCPs. This permits you to 
tailor an FCP, but does not require you to edit the build command 
files. To build a tailored FCP, enter OTHER in response to this 
question; SYSGEN will pause prior to building the privileged 
tasks to allow you to specify the FCP build command file that 
best suits your application needs. The following lists the FCP 
build command files and summarizes the task builder options of 
each. , 


FCPNMHBLD.CMD 


Size: 2.0K 
No task builder options 


FCPSMOBLD.CMD 


Size: 2.25-2.5K 
FCBs: 0 
Shared directory buffer: 1 block 


FCPSM1BLD.CMD 


Size: 2.75-3.0K 
FCBs: 32 
Shared directory buffer: 1 block 
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FCPMDOBLD.CMD 


i Size: 3.6-4.0K 
FCBs: 0 
Shared directory buffer: 1 block 


FCPMD1BLD.CMD 


Size: 5.0-5.25K 
FCBs: 32 
Separate directory buffer: 3 blocks 


FCPMD2BLD.CMD 


Size: 6.1-6.4K 
FCBs: 64 
Separate directory buffer: 5 blocks 


FCPLGOBLD.CMD 


FCBs: 0 
Shared directory buffer: 1 block 


FCPLG1BLD.CMD 


Size: 6.4-6.7K 
FCBs: 32 
Separate directory buffer: 4 blocks 


FCPLG2BLD.CMD 


Size: 8.3-8.6K 
New’ FCBs: 64 
oie Separate directory buffer: 8 blocks 
Also includes separate buffer for index file bitmap 


FCPLG3BLD.CMD 


. Size: 9.6-9.9K 
FCBs: 128 
Separate directory buffer: 12 blocks 
Also includes separate buffer for index file bitmap 


FCPCOOBLD.CMD 


Size: 6.0-6.25K 
FCBs: 0 

% Separate directory buffer: 0 blocks 

x P Y 
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FCPROOBLD.CMD 


Size: 6.75-7.0K 
FCBs: 0 
Separate directory buffer: 1 block 


FCPRO1BLD.CMD 


Size: 8.0-8.25K 
FCBS: 32 
Separate directory buffer: 4 blocks 


FCPRO2BLD.CMD 


Size: 9.8-10.1K 

FCBs: 64 

Separate directory buffer: 8 blocks 

Also includes separate buffer for index file bitmap 


FCPRO3BLD.CMD 


Size: 13.0-13.25K 

FCBs: 123 \ 

Separate directory buffer: 12 blocks 

Also includes separate buffer for index file bitmap 


For systems with several high-performance disks, it is possible 
to increase file system throughput by mounting each volume with a 
separate FI1ACP, Distinct ACPs allow a separate pool of FCBs for 
each disk volume in each PI11ACP partition, and allows overlapping 
Girectory requests on each volume. The ACP default name 
algorithm of the Mount command simplifies specifying separate 
ACPS (see the RSX-11M/M-PLUS MCR Operations Manual). For 
example, if your system includes DECtape, install a separate 
version of FI1lACP (the non-multiheader version, FCPNMH, is 
adequate for DECtapes) with the name DTO1F1, the primary default, 
or DTAACP, the secondary default, 
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NOTE 


It is recommended that file system not 
share a user-partition with tasks that 
perform file-structured I/0, especially 
in systems with minimal user memory. 
The operation of RSX-11M is heavily 
dependent on the file system. Nearly 
all tasks request processing from it. 
Thus, for a system to operate properly, 
the file system must be in a partition 
where it can react promptly. Most tasks 
request an I/O operation through F11ACP, 
and while this I/0 operation is in 
progress, the tasks cannot be 
checkpointed. Thus, if F1lACP is 
running in the same partition, it may 
not be able to be loaded into memory to 
process the request and a deadlock 
situation can occur. 


SYSPAR's base address in 32 word blocks {100:1700:N] 


This question appears for unmapped systems only. Note that the 
default response (N) is determined by the FCP you selected (300 
for FCPNMH, 301 for another FCP). 


SYSGEN uses the response to this question in a nominal attempt to 
ease user burden in an unmapped system generation. SYSGEN 
creates a file (SYSPAR.CMD) which contains the base address and 
length of parition SYSPAR. However, SYSGEN cannot determine the 
exact location for partition SYSPAR. You should consult the map 
of the Executive to determine where the Executive ends and thus 
where to begin SYSPAR (symbol $SYTOP in the map of the Executive 
is the highest Executive location). 


Build the unprivileged queue manager utilities 

The response to this question specifies whether or not the 
nonprivileged queue manager utilities are built by Phase II. 
Appendix D describes the queue manager. 

Build the task PMD 

The response to this question specifies whether or not the Post 
Mortem Dump task is built by Phase II. The RSX-11M/M-PLUS Task 
Builder Manual describes the PMD task. 

Build RMDEMO 


The response to this question specifies whether or not the RMDEMO 
task is built by Phase II. Appendix B describes RMDEMO. 


Build the non-queue manager print spooler 
If you did not select support for the queue manager in Phase I, 


this question permits you to build the serial despooler (V3.1 
spooler). 
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The serial despooler prints listings Simultaneously with the 
operation of other tasks. The MACRO-11 assembler, Task Builder, 
and FORTRAN compilers try to spool all listings or map files to 
disk. If neither the serial despooler nor the queue manager are 
installed, the files remain on disk. If the serial despooler is 
installed, it is started and thus prints any files in its receive 
list. 


For optimum operation, the serial despooler should occupy its own 
2K partition, although this is not necessary if the GEN partition 
is large. It can be built checkpointable or not checkpointable. 


Under normal circumstances, the serial despooler deletes only a 
small class of files after printing. You can build a deleting 
serial despooler by editing the task-build command file 
PRTBLD.CMD; locate the line GBLPAT=PRT:SDELET and change it to 
read GBLPAT=PRT:SDELET:1. 


You may supply an alternative file deletion algorithm and include 
it in task PRT. The module should define the global entry point 
$DELCK. The routine is called with register RO containing the 
FDB of the file just printed. On return, RO must be preserved 
and the processor status C-bit should be set to indicate that the 
file is to be deleted. 


Use of this feature bypasses all of PRT's default file deletion 
logic. To include this module, insert it in the object library 
PRT.OLB, and edit the task-build command file PRTBLD.CMD, 
deleting the following line: 


GBLDEF=$DELCK: 0 


Before a file is printed, an identification page is generated. 
This page contains the RSX-11M version number; the date and 
time; and the device, UFD, and name of the file being printed. 
In addition, the file name is printed in large block letters for 
readability. Two .formats are available, a large one for 
132-column printers, and a smaller one for 80-column printers. 


You may build PRT to omit the file identification page by 
modifying a global patch in the task-build command file as 
follows: 


*F GBLPAT=PRT:SFLAG 
GBLPAT=PRT:$SFLAG: 1 
*C/1/0/ 
GBLPAT=PRT:SFLAG:0 


Note that the value specified in the GBLPAT statement is used to 
determine the number of title pages printed. There are 
additional options for specifying flag page size and the number 
of trailing form feed characters to be printed. The task-build 
command file, PRTBLD.CMD, contains detailed commentary concerning 
these options. 


SYSGEN then displays a list of the build files for the privileged 
tasks to be built and asks question 17. 


17. 
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Edit any privileged task build files 


A Yes response causes SYSGEN to pause to allow selective editing 
of the privileged task build command files. 


For mapped systems, it is not required that you edit the task 
build command files. 


For unmapped systems, you may have to edit the privileged task 
build command files so that the partition statements reflect 
actual base addresses. All of the tasks to be built have task 
build command files that specify either partition SYSPAR, GEN, or 
PAR14K. You specified the base address of SYSPAR in question 12. 
Thus you do not have to edit the SYSPAR partition statement. 
Partition GEN is assumed to be based at 40000(8) and to be 
40000(8) bytes long. You must edit the build command files if 
this assumption is inaccurate. Also, partition PAR14K is assumed 
to start at 40000(8) and to be 70000(8) bytes long. 


The privileged tasks must always be rebuilt when the Executive 
has been rebuilt. The privileged tasks are linked to the 
Executive symbol table file and map into the Executive address 
space so that they may access various system lists and data 
structures, If the Executive is changed, these addresses change; 
thus, the tasks have to be rebuilt. 


The Line Text Editor (EDI) may be used to examine the PAR command 
line in each file that may require modification. Every file in 
question must be checked, since a Partitions command which does 
not reflect the requirements of the user-tailored system can 
produce tasks which will not run or could crash the system. 


For an unmapped system, tasks built to run in SYSPAR have the 
proper task builder command. Those built to run in the GEN 
partition specify 


PAR=GEN: 40000: 40000 
For mapped systems, the respective commands are: 


PAR=S YSPAR: 0: 10000 
PAR=GEN:0: 40000 


If alteration is necessary, the change may be accomplished as 
shown below. Suppose, for example, the GEN subpartition is to 
Start at 50000(8). The above sequence would be changed to: 


>EDI BOOBLD.CMD 
[PAGE 1] 

*L PAR 

PAR=GEN: 40000: 40000 
C/N 34M :5 
PAR=GEN:50000: 40000 
*EX 

[EXIT] 


There are two versions of MCR: a single user version, MCR; and 
a multiuser version, MCRMU. The single user version processes 
commands serially and runs in partition SYSPAR. The multiuser 
version consists of two tasks, MCRMU and SYS. Task MCRMU 
receives commands in serial, but passes most on to task SYS for 
processing. The multiuser version achieves a degree of 
parallelism since multiple copies of task SYS can be running (one 
for each terminal). Task MCRMU runs in partition SYSPAR while 


18. 


19. 
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task SYS runs in GEN. Edit the task build command files to 
change partition statements. (Note that MCRMUBLD.CMD controls 
the task-build of both MCRMU and SYS.) 


The default partition for TKTN is SYSPAR. Normally, you need not 
edit the build command file. 


The tasks BOO, DMO, AT., INI, INS, LOA, MOU, SAV, UFD, and UNL 
build to run in GEN. For unmapped systems, you will have to edit 
the build command files if partition GEN does not start at 
40000(8). 


Map device for privileged tasks (ddv:) [D:NL:] 

Usually, these maps are of little use to the mapped system user 
and are not needed. The default response directs the maps to the 
null device. For an unmapped system user, the maps are of use if 
you want to determine the exact size of the tasks. 

If you want the maps, enter a device specification. Note that if 
you enter other than LP:, SY¥:, LB:, TI:, or TT:, the device must 
be mounted and a UFD entry of [1,30] for unmapped systems or 
[1,34] for mapped systems must exist. 

Edit SYSVMR.CMD 


SYSGEN Phase II creates a file (SYSVMR.CMD) to create the 
partition structure, install tasks, and load loadable drivers. 


This question permits you to edit the SYSVMR.CMD file. 

For mapped systems, it is not necessary to edit this file; 
although it may not produce an optimal system on small 
configurations. SYSVMR.CMD typically produces a valid mapped 


system image. The following depicts a mapped system partition 
structure that results from executing SYSVMR.CMD 


DEV common 
(optional) 
FCPPAR 
(optional) 
SYSPAR 


DRVPAR 
(optional) 


TTPAR 
(optional) 
LDRPAR 
(optional) 
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For mapped: systems, SYSVMR: 


® Extends pool space to the maximum size of the Executive 
(either 16K or 20K). If you do not want to use the 
maximum amount of pool, edit SYSVMR.CMD; locate the line 
SET /POOL=* and change the wildcard specification to use 
the value of $SYTOP rounded up to the next 32-word block. 


o If you selected the loadable loader, creates the partition 
LDRPAR and installs and fixes the loader in it. 


® If you selected the full duplex terminal driver, creates 
partition TTPAR and loads the terminal driver into it. 


@ If you selected loadable drivers, creates partition DRVPAR 
and loads all loadable drivers built during the running of 
Phase II into it. If you do not want to load all drivers, 
edit SYSVMR.CMD; delete the load command for each driver 
you wish to exclude. Note that you should load the system 
disk driver first so that you can boot the system from an 
unmapped system. 


NOTES 


If you are restarting SYSGEN Phase II 
(you responded Yes to question 6), 
SYSGEN cannot determine which drivers 
were built for the system. Therefore, 
you must edit SYSVMR.CMD and insert the 
load commands for the drivers. 


SYSGEN uses wildcards (*) to create 
DRVPAR's size as the sum total of all 
drivers loaded at VMR time. If you wish 
to allow space for other drivers, edit 
the partition statement and specify 
sufficient space. 


Rather than delete command lines’ that 
load drivers that you do not need, it is 
suggested that you insert a semicolon 
(7) at the beginning of the line. (VMR 
treats such lines as comments.) : 


® Creates partition SYSPAR and, if you selected FCPNMH, 
installs FCPNMH into it. 


o If you selected other than FCPNMH, creates partition 
FCPPAR and installs the FCP. 


@ Creates partition GEN (from end of last partition to top 
of memory) 


o If you selected direct access to device registers for 
IP11/I1P300, ICS/ICR, UDC11, or DSS/DRS devices, creates 
DEV common, which overmaps the I/O page to permit direct 
access to the device registers. 


For unmapped systems, it is not possible for SYSVMR.CMD to create 
an optimal partition structure; ‘you must edit SYSVMR.CMD. The 
following depicts an unmapped 16K to 24K system that results from 
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executing SYSVMR.CMD. Note that for unmapped systems, SYSVMR 
does not create driver partitions. 


devPAR 


1000 


400 


300,301 


For unmapped 16K - 24K systems, SYSVMR: 


If you selected other than FCPNMH, establishes the top of 
pool and the Executive at location 30100. If you selected 
FCPNMH, establishes the top of pool and the Executive at 
location 30000. 


Creates partition SYSPAR. The base address, and thus’ the 
length, depends on the FCP you selected. For FCPNMH, 
SYSPAR starts at 30000 and is 10000 bytes. For other than 
FCPNMH, SYSPAR starts at 30100 and is 7700 bytes. 


Creates partition GEN and attempts to install all tasks 
into it. 


The following depicts an unmapped 24K-28K system that results 


from 


executing SYSVMR.CMD. Note that for unmapped systems, 


SYSVMR does not create driver partitions. 


FCPPAR 
{optional} 


PAR 14K 


SYSPAR 
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For unmapped 24K-28K systems, SYSVMR: 


@ Establishes the top of pool and the Executive at location 
30100 for other than FCPNMH or at location 30000 for 
FCPNMH. Be sure that this location is above the Executive 
(for example, SSYTOP). 


e Creates partition SYSPAR. The base address, and thus’ the 
length, depends on the FCP you selected. For FCPNMH, 
SYSPAR starts at 30000 and is 10000 bytes. For other than 
FCPNMH, SYSPAR starts at 30100 and is 7700 bytes. 


e Creates partition PAR14K (base address is 40000, length is 
70000 bytes) and a subpartition GEN (base address is 
40000, length is 40000 bytes). 


e If you selected other than FCPNMH, creates partition 
FCPPAR. 


7.2 DETAILS OF LOADABLE DRIVER BUILD PHASE 


This section provides details for SYSGEN processing of loadable driver 
task-build command files. 


The file SGNBLDDRV.CMD controls the task building of loadable drivers 
and also permits incorporation of user written drivers. 


This command file executes during SYSGEN Phase II when your’ system 
includes loadable drivers or if you specified that you wish to include 
a user written driver. Note that the file can be used by itself to 
aid in task building (or re-task building) drivers. 


If you initiate SGNBLDDRV.CMD, you must answer questions 1-5; if 
SYSGEN calls the file, these parameters are known. 


1. Are you building drivers for a mapped system 

2. Does your system include any user written drivers 

3. Are you building drivers for an RSX-11S system 

4. Does your system include the KMC-LP driver 

5. Does your system have the full duplex terminal driver 
6. Device for driver's maps 


Unmapped systems require these maps. If you are generating an 
unmapped system, the default map device is SY:. 


Typically, mapped systems do not require these maps. If you are 
generating a mapped system, the default map device is NL:. 


NOTE 


If you want (or require) the maps and 
specify a device other than SY:, LP:, 
LB:, TT:, or TI:, SYSGEN requires that 
the device be mounted, ready, and that 
the proper UFD ([1,30] for unmapped, 
[1,34] for mapped) exists. Also, the 
driver must be loaded. - 


Ts 


8. 


9. 


10. 


ll. 


12. 
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Spool maps 


This question does not appear if SYSGEN calls SGNBLDDRV since you 
specified whether or not to spool listings and driver maps in 
Phase I. 


Does the map device have at least 120 columns 


This question does not appear if SYSGEN calls SGNBLDDRV since you 
specified whether or not the map device has 120 columns in Phase 
I. 


If you enter No, the task builder uses the /-WI switch to print 
Narrow maps. 


Build all selected loadable drivers into DRVPAR 


This question appears for mapped systems only. Normally, all 
loadable drivers in a mapped system are built to run in partition 
DRVPAR. 


If you enter Yes, SYSGEN builds all the loadable drivers you 
selected in Phase I for partition DRVPAR, 


If you enter No, SYSGEN prompts for the drivers you want to build 
(see question 10). 


Driver 2-character device mnemonic 


This question appears for unmapped systems and all systems’ that 
include user written drivers. The question also appears if you 
are generating a mapped system, but do not want to build all 
selected drivers or if you wish to build mapped loadable drivers 
for other than partition DRVPAR (responded No to question 9). 


Enter the 2-character device mnemonic for each loadable driver 
you want to build. SYSGEN then prompts for the partition name 
(in question 11). When complete, enter carriage return. 

Driver partition name 


The default for mapped systems is partition DRVPAR. 


The default for unmapped systems is partition devPAR where dev is 
the 2-character device mnemonic specified in question 10. 


For unmapped systems, consider building the system disk driver 
for the partition that corresponds to 2-character device 
mnemonic. This is also recommended for other drivers that run in 
their own partition (for example, TTPAR). A suggested partition 
name for less frequently used drivers is DEVPAR. You can Load a 
driver as you need it (after unloading other drivers). 


devPAR's partition base address 
This question appears for unmapped systems only. 


Enter the base address of the specified partition. 
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7.3 DETAILS OF SYSGEN PHASE II PROCESSING | 


During a system generation, SYSGEN issues command lines and displays 
comment lines. This section uses the console listing from the SYSGEN 
described in Chapter 5 to detail and describe the command lines as 
well as interpret the more obscure comment lines. 


The console listing appears below. It is followed by notes which are 
keyed to the listing. 
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>@SYSGEN2 

4 RSX-11M Version 3.2 BL26 Sustem Generation Fhase II 

Ds Coryright (C) 1978 lisital Eauirment Corrorations Maynard Mass. 
5 SYSGEN Fhase Ii started at 13%10931 on 23~MAY~79 

# 1. Im what UIC is SGNFARM.CME if mot £20022007 CSit 


RLO1 distritution kit SYSGEN versions 3.2.20 / 213.2.2¢ 
Continuation from SYSGEN ehase I done om 23-MAY-79 at 13f08t18 
2. Exranded comments desired for SYSGEN ehase IL? CY/NI? 


4. Is SYSGEN still running stand-alone? CY/NILY 
Se If mot in UL: enter ohJect files device when ready (ddut) CST 


OO Y YW vo 


% 


we HHO wwe we 


>MOU DL1?MAPSRCE 

MOU -~ OTHER VOLUME MOUNTEL - Dit 1) 
>ASN DLIt=LB3 

SASN SYt#TK3 

“INS SYt$FPIF 

=PIF /FR 


DLO} HAS 2957. BLOCKS FREE» 7283, BLOCKS USED OUT OF 10240. 
LARGEST CONTIGUOUS SPACE = 2750. BLOCKS 


73 Create system libraries 
>INS $LBR 

-SET /UIC=C119 

>PTF ANSLIB.OLB/NV=SYSLIB.OLB 2] 
2LBR ANSLIB/RF=LESFCSMTA 
MODULE “ANSPAI" REPLACED 
MODULE "ASSLUN* REPLACED 
MODULE "BIGBUF* REPLACED 
MODULE "CLOSE " REPLACED 
MODULE “"CREATE*® REPLACEL 
MODULE “TRECT" REPLACED 
MODULE "GET * REPLACED 
MODULE “GETSQ " REPLACED 
MODULE SOREN © REPLACED 
MODULE "ORF IO § REPLACES 
MODULE "QPENB " REPLACED 
MODULE "POINT " REPLACET 
MODULE "FUT “ REPLACED 
MODULE “FUTSQ * REPLACED 
MODULE "ROWALT" REPLACE 
MODULE "RETADR" REPLACED 
MOOULE "RWELIE * REPLACE TH 


MODULE “WATSET" REPLACEN 


MODULE "WTWATT" REPLACED 


ok 6. Have you already built the libraries» the Execs and the loadable drivers? CY/N1% 
Be 

2 Start of Executive and driver build ehase at 1311144 on 23-MAY-79 

fF 

3 
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SGET /UTCE 1 924) 

SEIP RGXLIM. OLB sX/DE/NM 

SLAR RSXLIM/CR 290.2640. 8256-2011 2241 RGX11M ORS 3] 
2REM PIF 


SINS SY{$BIGTKE 
INS -~ PARTITION FARLAK NOT IN SYSTEM: DEFAULTING TO GEN 


Nee 


? 3 
>) Tasknuild the Executive 
mi 
“INS SYI$P IF 
DEIP [L234 14. K/DEZNM @ 
REM PIF 
*TRE @RSXBLE 
rn 
SK EOX * Did the Executive budld successfully? CY/NICY 
Po 
SBSEYT /UTCe (1954 
SING SYtSPIF 5) 
SPP LB? /NVeERSX LIM. STR 
SREM PIF 
“ING SY28F 
2K 10. List Executive mar? CY/NAt 


»y Build Loadable drivers 


> 6. Bevice for driver’s mars CMS NL3d cSae 
oR 9. Build all selected loadable drivers into DRVPAR? CY/NIZY 


SUTCHE Ly ta 
OL 200 22001 TTORVELD 
02009 2007 TTORVEL DO. CMS X/ TE 
Cie S4 TTORV.STE/TR 
OL 200 » 200 TNBURVEL Le 
200% 200 JTIBOIRVBL TG. CMI K/ TIE 
Cie S4cRORY . STRSTR 6] 
@L200 » 200 J DKIRVEL Lt 
C2009 200 J DKERVELE. CMD K/TIE 
C1954 7 DKORV,STE/TR 
OL 200 ve 2007 0L ONY BLD 

£200 200 70LURVBLO, CMI K/TIE 
Cie JAITLEY. STESTR 
@0 200» 200 10MERVEL Tt 
£2009 200 XTIMIRVELO, CMI K/TE 
Lay S47 2MORY.STER/TR 
O0200 2200 J 0S0RVELM 
£2007 200 J NSTRVRL. CMD TUE 
Ci S4  NSukV.STB/TR 
EL200% ZOO IN THRYVBL DD 
£2009 200 0TORU BIN 6 CMI K/ THE 
Civ S40 TORY. STR/TR 
OL 200 » 200 TNXURVBL 
* F2009 2OOANXTIRY BLL. CMI ZTE 
C 1 ia. JUXDRY . STBATR 
DRVBL 
VLE CMI KATE 


KE @£200 200 1MMORVELM 
£200» 200 1MMORVBLD 6 OMI K/ TE 
Le S1MMORY . STER/TR 


aQwbive and driver builded ehage at LIAO on 2a-MAY-79 


Erect of lita 


neo ver“! 


Taek Budda the erivilesed task 


ros MIXED OSes 
3? LY/NULY 


Gehchat) Cts Nis tk boas 
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#SY3 
SAGN TLOSeLES 
=TKB @ROORLD 
*TRE @0MOBLT 
=TRB @FCFEMIA BLD 
STRE @INDBLO ! GENERATING SMALL. INDIRECT 
=TRB @INTELT 7] 
=TRE GINSBILD 
STRE @MCRMUBLO 
=TRKB @MOURL DI 
=TRE @QMGRLD 
=TRE @QMGCLIBLI 
=TRE @QMGFRTBLO 
>TRE GLEFBLIE 
STRE @FLIMSGRLI 
=TRE @MTABLD 
=TKE @SAVELI: 
=TRKE @TKNELEE 
“TRE @QUFDBLD 
=TRKE @LOARLI: 
=TRE @GUNLBLD 
STKE @FMOBLD 
=TRE @RMOBLID 
=TRE @SHFEID 
STKE GACNTBLDD 
“TRB @BYERBLD 
STKE @HELBLID 
=TKB @BROBL IE 
2TRE @SHUTUP ELI 
>TKE @ACSELYD 
*TRE @ERF ERLE 
*TRKE @GERLBLD 


, 
= EOX *& Did the rrivileded tasks build successfully? CY/NILY 
fad 
REM TRE 
SASN LE?=SYt ; 

SASN LHe 

*ASN =SYt 8] 
SASN DLOT=S73 

SASN DLAt=LBs 

SET /UTC#E19547 

SRIF /FR 


BLO} HAS 1253. BLOCKS FREE» 8987, BLOCKS USED GUT OF 10240, 
LARGEST CONTIGUOUS SFACE = 1017. BLOCKS 


SGN -~ SYSGEN will now rause to allow vou to create wour 
RSXLIM.SYS file using the following examele. Ideally 
sour system it should occurs the same number of blocks 
as indicated in the examrle, 


* ‘ f 
a a Ta TS 


PEP RSXLIM+SYS/NV/CO/EI. 2 499.2RSXL1M.TSK 


AT, -- FAUSING. TO CONTINUE TYPE "BES ...AT." © 
RSXLIM+SYS/NV/CO/BL 2498. =RSX1LIM. TSK 
+o ATs 


AT. oe CONTINUING 


EM PEE 
2 19. Edit SYSYMR. CMD? RYZNAG 
5 SYISBNOF 1. © 


HUMES 
SY ees 


a 


) 


wey 


SNAME? @SYSVUMR 
VME ~~ INSTAL. TASKS 
SET eTOF TIRVEAR 3 
38704203870. 

Ro1L17734 90120000 
DRVPAR 117420 O0O12822400 
LA7SS4 00122400 
90124400 


00133300 
00134400 
001346000 
00137100 
00143000 


901953000 
00143000 
90207000 
1474634 Io 


oe i 


O3. 94 112344 SY 
ee RMD VOL 114444 GE 
MTAACF OO10 414044 GE 
ooo lIMO 22.00 114344 GE 
MCR. +. O8.01 113244 SY 
+e eMOU 22615 112744 GE 


eee MCR OL 112444 GE 
FILACE MOS20 115444 FC 
PMIl.6s OS 113444 GE 
SHF +++ 04 Vhs o SY 
+e eTNS 04 GE 
1+ +BAV 04,282 GE 
ee UPD YO4ALO GE 
3 + O1.604 GE 
O1.OR 14 GE 
01.606 114744 GE 
04.25 113744 GE 
O2 
20401 
; 149 
149 
+ OL 


LPO s 
NEOs 
DELS 
DBR: 
TRS ¢ 
oes 


et 
THOS 
Tas 
TiMO? 
TM13 
NSos 
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MAY NO LONGER FIT IN 


90002400 
00030400 
00002000 
90001100 
90002100 
009002500 
90001000 
00001100 
90001400 
90001100 
00003700 
90010000 
00010000 
00024000 
03571000 
RPAR 248. 
SPAR 248. 


N AIDE 


Be al & 


N 200. 
N 140. 
SPAR 1460. 
N 160. 
N 160. 
FPAR 149, 
N 140. 
SPAR 10%. 


EN 100. 


N 100. 
N 100. 
N vars 
N 70+ 
N 704 
N 45. 
ol. 
40+ 
0 « 
04 
0% 
SO. 
m0. 
0 6 
eles 
50-6 
S10 « 


MAIN 
MAIN 
SUB 
SUB 
SUR 
SUB 
SUE 
Sum 
Suk 
SUE 
SUR 
SUB 
MATIN 
MAIN 
MAIN 


00002400 
00010000 
90040000 
90013500 
00040000 
00010000 
90040000 
90020000 
00024000 
20000 
09010000 
00040000 
00040000 
00040000 
00040000 
00001100 
00040000 
00040000 
00040000 
00040000 
00040000 
00040000 
90040000 
09040000 
00040000 
00040000 
00037000 
00003700 
00040000 


000 


TASK 

SYS 
HRIVER = 
DRIVER 
DRIVER ~ 
DRIVER 
DRIVER ~ 
DRIVER ~ 
RIVER ~ 
DRIVER ~ 
URIVER ~ 
DRIVER ~ 
TASK 

Sys 

SYS 


10) 


ee ee ee 
SSesssssosssososcs 


erocrrrrrrrrrrrrrroccrrcrrrrcrrrces 
cocscocoooccocsescs 


S444 Oe 99 00 90 4H oe o4 Oe oe we He te He Ot 40 20 40 40 © 20 oe 20 oe Py te te oe 


eartiTion @ 


i) oy 
DRT 
TH 
Tims 
ngs 
nr? 
0X3 
LPS 
MMS 
TT? 


NZ) 


“00016770 FIXED 
-00020165 
~OO021331 
-~00021064 
~00017367 
= 00020241 
~00020202 
90020400 
~000174605 
= QOOORL4&A4A4 
00020304 
00017657 
~O0021 233 
BES open 
~OOQ205 
~OOOR ae 
-00021000 
~00020001 
“000201735 
~QO0201L05 
“99920650 
00020650 
000203523 
00017451 
~OO0OR1727 
—QO0R 1274 
“OO0R1L463S 
Foeceee as 
“000205 
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LOA THE 
LOAXEN 
LOADED 
LOAnEN 
LOAN 


LOATED 
L.OAIET 


TT363 LOAL 
TT373 Lo 
TT403 L. 
TT413 LOAnED 
TT423 LOANED 
TT433 LOADER 
TT44% LOARED 
TTAS? LOATHED 
TT463 LOATIED 
TIO? 

COOt  TTOs 

CLO? TTOE 

LEO? TRO? 

SYO3 TRO? 

UMRE OZ 


When the indirect file exitsys boot in sour tardet sustems 
set the date anc times and save the sustem with a hootstrar. 
When your sustem reboots itself,s eurde the oled task files. 


Aan alternate version of SYSLIB called ANSLIB has been created 
ar the RGXM26 disk to take into account ANSE surerort and Rid-bufferina. 


Peart vou may wart to 
Saltdlities in SYSGEN ehase IEl to take 
rt, Note this will cause an increase 
ity compared with the nom-ANSL version. 


ted ANST magtare su. 


f ANST 
e oof the 


hOME> cae E> “Ee en Seo ee Gd ce eh cae “en vce ce 


Yon?’ t forget bo create accounts after saving your sustem 


Er af SYSGEN ehase TL at 14236736 on 23—MAY-79 


“EOE 


i 


NOTES 


©2 @ e080 8 8 


e 6 68 6 Oo 


At this 
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SYSGEN mounts the mapped source disk, establishes logical 
assignments, and issues a PIP command to display the amount 
of free disk space. 


This section creates the system libraries and uses’ the 
librarian (LBR) to replace modules with their ANSI 
equivalents. 


The old libraries are deleted and then SYSGEN invokes LBR_ to 
create the Executive libraries. 


SYSGEN deletes the task build maps. 


SYSGEN creates a new symbol table (.STB) file (the baseline 
system STB file is no longer needed). 


This section builds the loadable drivers. Note that SYSGEN 
deletes unnecessary driver build command files after the task 
build completes and truncates the STB files. 


This section builds the privileged tasks. Note that SYSGEN 
builds the small version of the indirect command file 
processor. If you want to build the larger version of AT., 
you must do so manually. 


For mapped systems, build the 12K-word version from [1,24] 
(BIGINDBLD.CMD) to gain symbol table space. 


For unmapped systems, built the 14K-word version from [1,20] 
(BIGINDBLD.CMD) to gain symbol table space. 


SYSGEN swaps the logical assignments of the pseudo devices 
SY: and LB: and issues a PIP command to display free disk 
space. 


Kit variance. For RLO1 and dual RKOS kit users, you must 
create the file RSX11M.SYS based on the example. For big 
disk kit users, SYSGEN creates this file. 


SYSGEN installs Boot and VMR and then establishes logical 
assignments for VMR. 


This is a VMR warning message only. The message results from 
the VMR command that contracts the driver partition (SET 
/TOP=DRVPAR:-*). 


The command file SYSVMR loads drivers, installs tasks and 
issues the following display commands: 


SET /POOL 
PAR 
TAS 
DEV 


VMR then prompts to allow users to issue further commands or 
to exit. 


point, the system generation process is complete. The RSXM26 


disk contains a tailored and bootable RSX-11M version 3.2 system 


image. 


The following console display confirms it. 


DETAILS OF SYSGEN PHASE II 


“INS #800 
“MOU DL I RSXM26 
“BOO Dhills54] 


RSX-11M V3.2 BL26 S12k MAPFET! 
“RED DL3=Sy? 
PRED DLS eLes 
“MOU TLS RSXM26 
“QOL fE1»2ISTARTUF 
°k PLEASE ENTER TIME ANI DATE (HRIMN [lI-MMM-YY) EST? 
“TIM 12200 6-JUN-79 
ox ENTER LINE WI0TH OF THIS TERMINAL CO 0132.13 


“SET /BUF=TI2132. 


12300 6-JUN~-79 


“ACS SYi/BLKS=512. 

a] a 
“3 NOTE ~ The Baseline INDirect must be rerlaced by BIGINED with 

oF 8 rriority of 10. for SYSGEN. 

oF 

BS ie REM «+ +AT.s 

2S SINS $BIGING/FRI=10, 

DF 

*@ <EQF> 

=T IM» \> ~ 


12200325 06-JUN-79 
“9IT SEEMS OK 

=DEV 

LFO? OFFLINE LOATEL 


TROY 
DELS 


LOATIED 
LOADED 


TYPE=RPO6 
TYPE#RPO6 


DB2? LOALED TYFE=RPO4 
DRS? LOAVED TYPE=RFO4 

TKO? LOADED 

UKLt LOADED a 
NK2t LOADED 4 


DRS? LOADED 
LO? PUBLIC MOUNTED LOADED LABEL=RSXM26 TYPE=RL01 


GLit LOADED TYFE=RLO1L 

UMO? LOADED TYFE=RKO6 

UML? LOADED TYFE=RKO6 

nSO? LOADED TYPFE=RS04 

Si: LOADED TYPE=RS04 

TO? LOADER 

OTL? LOANED 

UXO? LOADED 

UX13 LOAED a, 
MMO? LOANED : 
MM1? LOADED 

TTO? CvI - LOGGED ON LOAIED 

TT1? LOADED 

TT2? LOADED 

TT3?3 LOADED 

TT4? LOADED 

TTS? LOALED , 
TT6? LOADED 
TT73 LOATEL 
TT1O% LOADER 
TTt1: LOADER 
TT123 LOADED 
TY133 LOADED 
TT14? LOADED 
TT15? LOAneEn 
TT16% LOADED 
TT17? LOADED -, 
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TT20? LOADED 

TT213 LOANED 

TT22: LOADED 

TT233 LOADED 

TT243 LOADED 

TT25: LOADED 

TT263 LOADED 

T7273 LOADED 

TT3O3 LOARED 

TT313 LOADED 

TT323 LOADED 

TT33%3 LOADED 

TT34? LOADED 

TT35: LOADED 

TT36% LOADED 

TT373 LOADED 

TT403 LOADED 

TT413 LOADED 

TT42: LOADED 

TT433 LOADED 

TT44¢ LOADED 

TT45?! LOADED 

TT46? LOADED 

TIO’ 

coo: TTO3 

CLO? TTO% 

LEO? DLO 

SYo} DLO? 

>PIP Ci954)%.x/PU 

MCR -- TASK NOT IN SYSTEM 

2INS #PIP 

SPIP C19543e.*%/PU 

PIP -- FAILED TO DELETE FILE 
PLOSC1s54]800.TSKS1 —- PRIVILEGE VIOLATION 
PIF -- FAILED TO DELETE FILE 
DLO{C1s54I0M0.TSKs1 -- PRIVILEGE VIOLATION 
PIP ~- FAILED TO DELETE FILE 
DLOtCisS4IIND.TSKF1 ~- PRIVILEGE VIOLATION 
PIP -- FAILED TO DELETE FILE 
DLOSCisS43INI.TSKSl ~~ PRIVILEGE VIOLATION 
PIP -- FAILED TO DELETE FILE 
PLOtCivS471INS.TSKFl ~~ PRIVILEGE VIOLATION 
PIF -~ FAILED TO DELETE FILE 
DLOtCisS4IL0A.TSKI1 -~ PRIVILEGE VIOLATION 


PIF -- FAILED TO DELETE FILE 
DLOtC1s54IM0U.TSKI1 ~~ PRIVILEGE VIOLATION 


PIP -- FAILED TO DELETE FILE 
DLOsSCisS4ISAV.TSKIL -- PRIVILEGE VIOLATION 


MCR>ABO PIP 


P 
TASK "+. sPIF" TERMINATED 
ABORTED VIA DIRECTIVE OR MCR 


AND WITH PENDING 10 REQUESTS 


> 
+$FORGOT TO CHANGE UICr CAN‘T DELETE FILES 


>GET /UIC#C17541 
>PIP C1y540%eX/PU 
>PIF /FR 


LO? HAS 1242. BLOCKS FREE» 8998. BLOCKS USED OUT OF 10240. 
BLOCKS 


LARGEST CONTIGUOUS SPACE = S19. 


>REM FIP 


CHAPTER 8 


VMR COMMANDS 


The Virtual Monitor Console Routine (VMR) is an RSX-11M system program 
that allows complete configuration of an RSX-11M system image file for 
booting. As its name suggests, VMR provides the capability to execute 
Monitor Console Routine (MCR) commands that are directed to the disk 
image of a system. 

VMR supports a compatible subset of the MCR commands described in the 


RSX-1L1M/M-PLUS MCR Operations Manual. All VMR commands have the same 


syntax and semantics as their MCR counterparts with the one exception 
of the SAVE command. 


8.1 STARTING VMR 
You can start VMR four ways. The first three methods apply when you 
have installed VMR and it is ready to be executed. The fourth method 
installs VMR automatically, executes it, and then removes it on exit. 
Method 1: 

>VMR @indirect 


The system loads VMR and executes the specified indirect command 
file; VMR then exits. 


Method 2: 
>VMR 
The system loads VMR, and VMR responds with the following prompt: 
ENTER FILENAME: 
Method 3: 
>RUN VMR 
The system loads VMR, and VMR responds with the following prompt: 
ENTER FILENAME: 
Method 4: 
>RUN SVMR 
The system installs VMR from the pseudo device LB: under the 
system UIC (normally, [1,50] or [1,54}]) and loads it; VMR then 
responds with the following prompt: 


ENTER FILENAME: 
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In all starting methods except method 1, VMR prompts with: 
ENTER FILENAME: 


At this point, you specify the file that contains the image of the 
RSX-11M system you want to modify. VMR expects to find a symbol table 
file of the same name as the system image file, but with a file 
extension of .STB, on the same device and under the same UFD as the 
system image file (except when you use the /IM switch; see Section 
8.2). For example, suppose you enter the following file specifier in 
response to the prompt: 


RSX118.S5YS 


A corresponding file, RSX11S.STB, must exist that contains the symbol 
definitions for the RSX11S.SYS system image. Note that the pseudo 
devices LB: and SY: on the running system must refer to the disk 
containing the system image file. 


The system image and symbol table files are in the standard format 
produced by the RSX-11M Task Builder. 


Upon receiving a valid file specifier, VMR opens and reads the symbol 
table file; it also opens the system image file and verifies that the 
file is actually a system image. VMR then prompts with 


VMR> 
You can now enter any valid VMR command or end VMR by typing CTRL/Z.1- 
If you used method 1 to start VMR, the specified file contains a 
series of commands to be executed by VMR. The first record in the 
file must contain a file specifier for the system image file that is 
to be modified. 


In addition to specifying an indirect file to start VMR, you can also 
enter the following any time that VMR prompts for input: 


@filespecifier 
This directs VMR to extract input from the specified file until it 
reaches an end-of-file and to return to the terminal for further 
input. This feature of VMR is useful when you want to repeat a series 


of commands for several generated systems (INSTALL commands, for 
example). 


8.2 VMR FILE SPECIFIERS 
File specifiers accepted by VMR are in the standard RSX-11M format: 


dev: [g,m]filename.type;ver [/IM] 


1 


CTRL/Z is typed by simultaneously depressing the CTRL and Z keys. 
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Parameters 


dev: 


The device unit on which the volume containing the desired file 
is mounted (for example, DKO or DT1). The name consists of 2 
ASCII characters, followed by an optional 1l- or 2-digit octal 
unit number. The default device is SYO. 


[g,m] 


The User File Directory (UFD), consisting of a group number and a 
member number. The default is the UFD that corresponds to the 
UIC under which VMR is running. 


filename 


The name of the file. An RSX-11M file name can be up to 9 
alphanumeric characters long. The file name and file type are 
always separated by a period (.). You must specify a file name; 
no default is applied. 


typ 


The file type, consisting of up to 3 alphanumeric characters. 
The defaults are SYS for system image files and CMD for indirect 
command files. 


ver 


The version number in the range of 0 through 77777(8). The 
default is the highest version. 


/IM 


A switch option that, when attached to the system image file 
specification and used with the SAVE command, overrides the VMR 
requirement for the symbol table file. 


This is the only switch provided with VMR. You use it to write 
non-RSX-11M system images to secondary media in bootstrappable 
format. 


When you use the IM switch with the file specification, the only 
command VMR will accept is the SAVE command. This switch is 
useful when you use an RSX-11M system as a host system to develop 
and create small, main memory resident systems that must be 
loaded from a serial medium (Such as paper tape). 


8.3 COMMAND SYNTAX 


You do not have to type an entire command name to VMR. VMR- accepts 
the first three characters of a command and then searches for a blank 
or tab followed by the command parameters or by a carriage return if 
there are no parameters. Because a blank or a tab is required before 
parameters, VMR does not allow embedded blanks in a command name. If 
you enter a command incorrectly, VMR displays an error message at your 
terminal. 
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The following example illustrates the TIME command. Note that the 
square brackets in the example indicate that the "E" is optional: 


VMR>TIM[E] <CR> 
14:00:04 21-MAY-79 


8.3.1 Keywords 


Some commands use keywords that generally apply to a command argument. 
A keyword consists of a Slash (/), followed by an ASCII 
identification, and optionally followed by an equal sign (=) and the 
value of the keyword, as follows: 


/keyword=value 


You can enter keywords in any order. As an example of keyword usage, 
the INSTALL command requires a file name argument specifying the task 
to be installed. You can append keywords to the file name. One such 
keyword, /TASK, specifies the name under which the task is to be 
installed. 


VMR>INS BOB. TSK/TASK=AMBER 


This command causes the task contained in the file named BOB.TSK to be 
installed with a name of AMBER. Keywords are command specific and are 
defined with each command. 


8.3.2 Comments 


VMR treats a line of text as a comment if the first character in the 
line is a semicolon (;). In addition, you can use the exclamation 
mark (!) to delimit comments in a command. The first exclamation mark 
starts the comment and the next exclamation mark or end of line 
terminates the comment. VMR ignores all text between the two 
exclamation marks. For example: 


VMR>; THIS LINE IS A COMMENT 
VMR>TAS !THIS IS A COMMENT STRING! 
Comments are especially useful to clarify commands in VMR_ indirect 


command files. (Refer to the RSX-11M/M-PLUS MCR Operations Manual for 


further information about indirect command files.) 


8.4 COMMAND SUMMARY 

The VMR commands described in this chapter are listed below by 
category. This command summary provides a compact overview of the 
facilities available through VMR. The detailed descriptions of the 
VMR commands given in Section 8.5 are presented in alphabetical order. 


Initialization Commands 


ASSIGN Define or delete a global logical device assignment. 
List current assignments on console terminal. 


INSTALL Install a task into the system image. 
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LOAD Load a device driver. 

REDIRECT Redirect all I/O requests from one physical device to 
another. 

SAVE Write the system image of memory onto a _ secondary 
media in bootstrappable format. 

SET Set system and terminal characteristics; define 
partitions; display terminal and partition 


characteristics on entering terminal. 


TIME Enter time and/or date into the system image; display 
the time and date on entering terminal. 


UNLOAD Unload a device driver. 


Informational Commands 


DEVICES Display on the entering terminal a list of peripheral 
devices defined in the system image. 


LUNS Display on the entering terminal the list of LUN 
assignments for an indicated task. 


PARTITIONS Display on the entering terminal the list of 
partitions defined in the system image. 


TASKLIST Display on the entering terminal a list of all tasks 
installed in the system image. 


Task Control Commands 


ALTER Alter the priority of a task. 

CANCEL Cancel the time-based initiation requests for a task. 
FIX Fix a task in system image. 

REASSIGN Change a task's LUN assignment. 

REMOVE Remove a task from the system image. 

RUN Schedule a task's activation. The task may run after 


one clock tick, after a delay, or in synchronization 
with the system clock. Periodic rescheduling is 
optional. 


UNFIX Unfix a task from the system image. 


8.5 VMR COMMAND DESCRIPTIONS 


The following subheadings are used in the detailed command 
descriptions in this section. Subheadings that do not apply to a 
particular command are omitted from the command description. 
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COMMAND NAME 
This subheading consists of the command name in capital letters. The 
minimal VMR command acronym is shown on the right margin. The text 
following the name describes the command's function. 
Format 

The command format is given, and all parameters are described. 
Parameters 

Parameters are listed and described. 
Examples 

Examples of using the command are shown. 
Notes 


A list of special considerations that may assist you in using the 
command properly appears under this subheading. 


ALTER 


Use the ALTER command to change the static priority 


task. 


Format 
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ALT[{ER] taskname /PRI=priority 


Paramete 


taskname 


The name of the task whose priority is to be altered. 


/PRI 
The 
priority 


The 
250 


Example 


Alter the static priority of task TEST TO 248(10). 


rs 


keyword that changes the task's static priority. 


new priority to be assigned to the specified task, 


(decimal). 


>ALT TEST /PRI=248. 


ALT 


installed 


from 1 


to 
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ASN 


ASSIGN 


Use the ASSIGN command to define, delete, or display logical-device 
assignments. Logical-device assignments are a way to associate 
logical names with physical devices, pseudo devices, or other logical 
devices. When you assign a logical name to a pseudo or logical 
device, the system resolves the assignment to the associated physical 
device. There are three types of logical-device assignment: global, 
local, and login. VMR supports the manipulation of global assignments 


only. See the RSX-11M/M-PLUS MCR Operations Manual for additional 
information on local and login assignments. 


The manipulation of global assignments applies to all tasks in the 
running system. 


A logical-device name has the same syntax as a physical device unit. 
It consists of a 2-character ASCII name (alphabetic) and an optional 
l- or 2-digit octal unit number, followed by a colon (3). The 
2-character name can either be equivalent to a standard RSX-11M device 


name (for example, DK:) or two letters picked at random (for example, 
XY¥:). 


When you install a task, or the system executes an ASSIGN LUN 
directive, the system scans the logical device table before it scans 
the physical device table when it searches for a specified device. As 
a result, you can define logical device names that are identical to 
physical device names even though the logical and physical device 
names do not refer to the same physical device. The system resolves a 
specified device name to the first matching table entry found. If a 
logical device name is identical to a physical device name, the 
logical name has precedence. 

Formats 

ASN ppnn:=llnn:/GBL 


Define a global assignment that associates the logical name llnn; 
with device ppnn:. 


ASN /GBL 
Display all global assignments for the system. 
ASN =[llnn:]/GBL 


Delete the specified global logical-device assignment or all 
global assignments if the command omits llnn:. 


Parameters 
PP 


A physical, logical, or pseudo device name. 
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nn 
: A unit number. 
~ 11 
A logical device name. 
S Examples 
VMR>ASN DK: =GB0:/GBL 
- VMR>ASN /GBL 
GBO: DKO: GLOBAL 
VMR>ASN =/GBL 


!Define global logical device 
Iname 


!List all assignments 


!Delete all global assignments 
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CAN 


CANCEL 
Use the CANCEL command to cancel time-based initiation requests for a 
task. These requests result from the RUNS directive or any of the 
time-synchronized variations of the VMR RUN command. 
CANCEL does not affect the execution of the task that may be active in 
the saved system image. It removes only the time-based schedule 
requests still in the clock queue. 
Format 

CAN(CEL] taskname 
Parameter 


taskname 


The name of the task whose time-base initiation request is to be 
canceled. 


Example 
VMR>CAN XKE 


Cancel all periodic rescheduling and time-based initiation 
requests for task XKE. 
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DEV 


DEVICES 
Use the DEVICES command to display on the _ entering terminal the 
symbolic names of all device-units or, optionally, all of a particular 
device type defined in the system image. The device names appear in a 
single vertical column. A second column contains any additional 
information about each device. 
Formats 

DEV [ICES] 

DEV[ICES] dd: 
Parameter 


dd: 


The particular device type to be displayed. 


Examples 
VMR> DEV 
DBO: LOADED 
DB1l: LOADED 
DB2: LOADED 
DB3: OFFLINE LOADED 
DKO: LOADED 
DK1; LOADED 
DK2: LOADED 
DSO: 
DSl: 
DTO: LOADED 
DTl: LOADED 
LPO: LOADED 
MMO: LOADED 
MM1: LOADED 
PPO: UNLOADED 
PRO: UNLOADED 
TTO: 
TT 13 
TT2: 
TT3: 
TT4: 
coo: TTO: 
CLO: LPO: 
SYO: DBO: 
LBO: DBO: 
VMR>DEV DK: 
DKO: LOADED 
DK1l: 
DK 2: 


The following list describes the messages that can appear in the 
second column. More than one message can appear on the same line. 
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OFFLINE indicates that, although the system tables contain 
entries for this device, the system as saved did not contain 
the related device. 


LOADED indicates that the driver for the device is loadable 
and is currently loaded. 


UNLOADED indicates that the driver for the device is loadable 
and is currently not loaded. 


A device name in the second column is the device to which the 
corresponding device in the first column has been redirected. 


Absence of either LOADED or UNLOADED in the second column 
indicates that the driver is permanently resident; it is 
linked to a part of the Executive. 
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FIX 


FIX- IN-MEMORY 
Use the FIX-IN-MEMORY command to load a task into its partition in the 
system image. The system can service requests for running the task 
more quickly because the task is memory-resident and does not have to 
be loaded from the disk before it can run. VMR can fix a task in the 
system image only if the partition in which it is to be fixed is 
available. On RSX-11S systems, all installed tasks must be fixed 
since they cannot be loaded into the running RSX-115S system. 
Fixed tasks remain in memory even after they exit. Therefore, they do 
not have to be reloaded when a request is made to run them. (Note 
that re-executing fixed tasks is not always practical.) Only an UNFIX 
or REMOVE command can free the occupied partition. 
The following restrictions apply to the fixing of tasks: 

e Checkpointable tasks cannot be fixed, 

@® Active tasks cannot be fixed, 

e A task must be installed before it can be fixed, 


e A task can only be fixed in a task partition, and not in 
system-controlled partitions. 


Format 
FIX taskname 
Parameter 
taskname 
The task that you wish to fix in memory. 
Example 
VMR>FIX XKE 


Fix task XKE in its partition. 
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INS 


INSTALL 


Use the INSTALL command to make a specified task known in the system 
image, or to load a common into a common partition. An installed task 
is dormant until the Executive receives a request for it to run. The 
optional keywords either provide parameters that were not specified at 
task build or override parameters that were. 


When a task is installed, VMR creates a Task Control Block (TCB) for 
the task in a system image table called the System Task Directory 
(STD). The task parameters contained in the TCB enable the system to 
run the task when requested to do so by an MCR command, VMR command, 
or a system directive. A task cannot be run until you install it. 


A task's TCB contains the address of the load-device Unit Control 
Block (UCB) and the Logical Block Number (LBN) of the task image file. 
The Executive can therefore load the task image in one transfer when 
an MCR command or system directive requests an installed task. 
(Loading requires more than one transfer if the task is greater than 
32K words.) 


When VMR installs a task in a virgin system, it stores the task's 
logical block numbers in the task header. When you save a system, the 
SAVE command places the file identification, rather than the file's 
LBN, in the TCB. Then, when the system is rebooted, it reopens the 
task file and stores the task's new LBN in its TCB. If a task has 
been deleted, the system cannot open the task file when the system is 
rebooted. The system then automatically removes the task's TCB from 
the STD. When VMR installs a task in a saved system image, it stores 
the task's file identification, rather than the LBN, in the TCB_ to 
allow a reboot to occur successfully. 


Also a saved system does not retain the physical addresses of 
installed tasks. The Disk Save and Compress’ (DSC) utility can 
compress and copy a disk containing a saved system, thus moving the 
task files to different physical locations. But because the TCB 
entries contain task file identifications, rather than LBNs, after a 
system save, the system can function normally when it is rebooted. 
Format 

INS[TALL] filespec[/keyword] [/keyword]... 
Parameters 
filespec 

A task image file specifier in the form: 


dev: [group,member]filename.type;version 


The type defaults to TSK, Standard defaults apply to the 
remaining fields. 
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_ keyword 
One of the keywords listed below: 


/CKP=option 


/INC=size 

/PAR=pname /SLV=option 
/PMD=option /TASK=taskname 
/PRI=number /UIC=[group,member] 


/PRO=[system,owner,group,world] 
Keywords 
/CKP=option 


The option is yes or no. If CKP=YES (default for checkpointable 
tasks), checkpointing is enabled for the task. If CKP=NO, 
checkpointing is disabled for the task. 


The /CKP keyword overrides the /CP switch specified at task 
build. 


On systems that support the dynamic allocation of checkpoint 
space, the task image file does not need to contain allocated 
checkpoint space. The presence of the /CKP=YES keyword instructs 
the system to allocate checkpoint space for the task when 
required from a checkpoint file. 


/INC=size 


The size is the number of additional words of address space to be 
allocated to a task. The extension size is usually expressed in 
octal but may also be expressed in decimal by appending a period. 
This keyword overrides the Task Builder's EXTTSK or PAR option 
keyword. Tasks such as MACRO-11, TKB, PIP, VFY, and AT. use the 
Space from the end of the task image to the end of their address 
space as dynamic memory in which to allocate symbol tables and 
buffers. The INC keyword defines the number of words in this 
dynamic region. The default size is the size specified at 
task-build time, or, if none specified at task build, zero. 


/PAR=pname 


A partition name that overrides the partition specified at 
task-build time. 


If the keyword specifies a nonexistent partition, VMR issues a 
warning message and attempts to install the task in the GEN 
partition. 


Default: TKB uses the name GEN. 


8-15 
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/PMD=option 


The option is yes or no. If PMD=YES, the system will perform a ~ 
post-mortem dump of the task if it aborts the task because of an 

SST error condition. If PMD=NO (the default from a_ task-build), 

the system will not perform a dump at SST abort time. 


To generate a dump, you must install the post-morem dump task 
PMD... in the system. 


This keyword overrides the Task Builder's /PM switch. The 
default is specified at task-build time. 


/PRI=number 
The number is the priority at which the task is to be installed. 
The value range is 1 through 250(10). Standard RSX-11M number 
conventions apply to this parameter. The default is PRI=50. 


/PRO=[system,owner,group,world] 


The PRO keyword establishes a protection mask for a common. The ri. 5 
user groups are defined as: ; 


e System - All system tasks running under a UIC group number 
less than or equal to 10(8). 


e Owner - Tasks that run under the same UIC as the files owner. 

@ Group - Any task that is running under the same UIC group as 
the file's owner. 

e World - Any task that does not fit in one of the above se, 
categories, | 


The PRO keyword establishes the access rights for each group. 
The four types of access are: 


e@ Read 
e Write 
e Extend 


e Delete 
For example: 
INS COM/PRO[RWED,RWED,R,R] 


gives read, write, extend, and delete access to the system and 
owner and read access to the group and world. 


/SLV=option 


The option is yes or no. If the command specifies /SLV=YES, data 
sent to the installed task is marked with the TI: of the sending 
task. When the installed task receives the data, the system sets 
the task's TI: to that associated with the data. This keyword 
overrides the Task Builder's /SL switch. 


If the command specifies /SLV=NO, the TI: of the task does not 
change when receiving data. The default is specified at task a, 
build. ~e 
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/TASK=taskname 


The name to be used to install the task. The default is the name 


specified at task-build time or the first 6 characters of the 
file name. 


/UIC=[group,member ] 


The square brackets are required syntax. This UIC is the default 
for the task. You can override it with the RUN command. The 
task YIC determines the file-protection class (system, owner, 
group, world) in which a task belongs, and thus directly 
influences file access. Note that file protection may differ 
from file to file. 


The default is from the task build. This default applies only to 
tasks started by a RUNS directive or a RUN command that specifies 
a time delay before runtime. Tasks started by typing the name as 
a command (for example, PIP and TKB) run under the default UIC of 
the terminal from which the command was issued. 
Examples 

VMR>INSTALL SCAN 
Install task SCAN using the default priority and UIC. 

VMR>INSTALL DK1: [1,111] SCAN .TSK;4/PRI=103 


Install task SCAN, file type TSK, version 4 from device DKl:, 
group number 1, member number 111, with a priority of 103(8). 


VMR>INS MAC/INC=4096./PAR=SYSCTL 


Install task MAC in the partition SYSCTL and increase the task 
size by 4096 decimal words. 
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LOA 


LOAD 
Use the LOAD command to load a nonresident device driver into the 
system image. The LOAD command constructs the data base and interrupt 
vector linkages required to allow access to the device. This command 
eliminates the need to link infrequently used device drivers 
permanently into the Executive. (Executive support of loadable device 
drivers is a system generation option.) 
Format 
LOA[D] dd: [/keyword=value] [/keyword] [/keyword]... 
Parameters 
dd: 
A 2-character ASCII device name. 
keyword 
One of the following three- or four-letter keywords: 
/PAR=pname 
/SIZE=psize 
Keywords 
/PAR=pname 
The pname is a partition name. The PAR keyword is used to name 
the partition into which the driver is to he loaded. It 
overrides the partition specified at task build time. 
/SIZE=psize 
The psize is partition size. The SIZE keyword is used to 
establish the minimum size (octal words) of the partition into 
which the driver is to be loaded. VMR rounds psize up to the 
next largest unit of 100 octal. Psize must be less then 77741. 
Examples 
VMR>LOAD MM: !LOAD TU16 DRIVER (MMDRV) 


VMR> LOA LS:/PAR=DRVPAR !LOAD LPS11 DRIVER (LSDRV) INTO 
!DRVPAR 


Notes 


1. Guidelines for building loadable device-driver tasks are 
rigidly defined. These guidelines are described in the 
RSX-11M Guide to Writin an I/O _ Driver. The system 
generation procedures include provisions to simplify the task 
building of drivers. 
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The LOAD command requires that a driver's TSK and STB files 
reside under the same UFD and on the same disk as the system 
image upon which you are working. For example, the following 
command requires that the files DTDRV.TSK and DTDRV.STB 
reside on SY: under the current UIC. 


LOA DT: 
The LOAD command requires pool space as follows: 
a. If the driver data base is being loaded, the command 
needs pool space equal in size to the size of the data 


base. 


b. The command needs pool space for an Interrupt Control 
Block (ICB) for each interrupt entry point in the driver. 


c. The command needs pool space for a Partition Control 
Block (PCB). 
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LUN 


LOGICAL UNIT NUMBERS 


Use the LUN command to display at the entering terminal the static LUN 
assignments for a specified task. (Static assignments are those 
recorded in the task's disk-image file.) The display consists of a 
list of physical device units in one column, with the corresponding 
LUNS in an adjoining column. 


Format 
LUN[S] taskname 
Parameter . 
taskname 
The task for which the LUNs are to be displayed. 
Example 
VMR>LUN XKE 
SYO: 
SYO: 
CLO: 
TT3: 
TT3: 


DKO: 
TT3: 


NOU BPWNE 


The display shows static assignments for LUNs 1 through 7 as 
recorded in the task-image file header; no other LUNs are 
statically assigned to the task XKE. 


J 
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PARTITION DEFINITIONS 


Use the PAR command to display on the entering terminal a 
of each memory partition in the system image. 


six columns that specify: 


l. Partition name 
2. Partition Control Block address (octal) 
3. Partition base address (octal) 
4. Partition size (octal) 
5. The partition type and, following the partition type, 
partition occupant(s) -- task, driver, common, etc., 
6. The name of partition occupant(s). 
Format 
PAR[TITIONS] 
Example 
Name PCB Base Size PAR/TASK Name 
VMR>PAR 
TTPAR 117734 00120000 00040000 MAIN TASK 
SYSPAR 117670 00160000 00010000 MAIN TASK 
TKNPAR 117624 00170000 00010000 MAIN TASK 
DRVPAR 117560 00200000 00027700 MAIN sYs 
117340 00200000 00002000 SUB DRIVER — DB: 
117240 00202000 00001100 SUB DRIVER - DK: 
117140 00203100 00002500 SUB DRIVER — DM: 
117040 00205600 00002300 SUB DRIVER - DR: 
116740 00210100 00001000 SUB DRIVER - DS: 
116640 00211100 00001100 SUB DRIVER - DT: 
116540 00212200 00001400 SUB DRIVER - DX: 
116440 00213600 00002100 SUB DRIVER - DL: 
116340 00215700 00001300 SUB DRIVER - LP: 
116204 00217200 00003700 SUB DRIVER —- MM: 
115550 00223100 00003000 SUB DRIVER - CO: 
LDRPAR 117514 00227700 00002400 MAIN TASK 
BASIC2 117450 00232300 00040000 MAIN COM 
GEN 117404 00272300 00175000 MAIN sys 
060400 00272300 00040000 SUB (...SAV) 
VMR> 


PAR 


description 
The display consists of 


the 
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REA 


REASSIGN 
Use the REASSIGN command to reassign a task's Logical Unit Numbers 
(LUNs) from one physical device unit to another. The reassignments 
affect only the static assignments recorded in the task's disk image 
file. 
The command does not affect a memory-resident' task. Therefore, 
REASSIGN has no effect on the assignments for a task that is fixed or 
loaded in memory. 
Format 

REA[SSIGN] taskname lun nud: 
Parameters 
taskname 


The name of the task for which the LUNs are to be reassigned. 


lun 
The logical unit number. 

nud 
The new device unit, which can be a physical, logical, or pseudo 
device, 

Examples 


VMR>REA JOE 3 TTO: 

Reassign LUN 3 of task JOE to device TTO:. 
VMR>REA BILL 2 TTl: 

Reassign LUN 2 of task BILL to device TTl: 
VMR>REA TEST 3 XX3 


Reassign LUN 3 of task TEST to logical device XX:. 


( 
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RED 


REDIRECT 


Use the REDIRECT command to redirect all I/0 requests from one 
physical device-unit to another physical device-unit. 


Note that an attached device and the device TI: cannot be redirected. 
In addition, one pseudo device cannot be redirected to another pseudo 
device. 
Format 
RED[IRECT] nud:=old: 
Parameters 
nud: 
The new device unit to which requests will be redirected. 
old: 
The old device unit from which requests have been directed. 
Examples 
VMR>RED TT3:=TT6; 
Redirect all I/0 requests for device TT6: to device TT3:. 
VMR>RED TT:=LP: 


Redirect all I/O requests for device LPO: to device TTO:. 
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REMOVE 


Use the REMOVE command to delete a task or region name from the system 
image. Removing a task from the system image makes the task unknown 
to the system. The action resulting from this command is the 
complement of INSTALL. 


The REMOVE command cannot remove an active task from a saved system. 


An example of such a task is the SAVE task; an attempt to remove SAVE 


from a saved system results in an error. The message TASK ACTIVE is 
displayed. 


Formats 
REM[OVE] name 
Parameter 
name 
The name of the task to be removed. 
Example 
VMR>REM SCAN 
Remove the task named SCAN from the system image. The task-image 
file remains unaffected. Note that tasks installed as ...XXX can 
be removed by 
>REM XXX 
or 
>REM ...XXX 


Notes 


1. If a task that is the object of a REMOVE command is’ fixed, 


the command automatically unfixes the task from the system 
image. 


2. REMOVE automatically cancels all time-based schedule requests 
for the specified task. 


3. You cannot remove a task if it has send or send-by-reference 
packets queued to it. 


RUN 
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RUN 


Use the RUN command to initiate the execution of a task. The command, 
which has four formats, can cause a task to be: 


@ Started one clock tick after system boot 
e Started at a time increment from the system image time 
@ Started at a time increment from clock unit synchronization 


e@ Started at an absolute time of day 


All of these options are available with or without rescheduling. 


Format 1 


Run one clock tick after system boot 


RUN taskname [/RSI=magu] [/UIC=[uic]] 


Parameters 


taskname 


A l- to 6-character taskname of the task that you wish the system 
to run. 


RSI 
The reschedule interval. The format is the same as for dtime, 
which is detailed below under format 2. The reschedule interval 
specifies how often you want the system to rerun the task. Each 
time the interval of time you have specified lapses, the system 
will make an initiation request for the task. The default is no 
rescheduling. 

uICc 
The UIC that has the format [g,m] where g and m represent the 
group and member numbers respectively. Legal group and member 
numbers range from 1 through 377(8). The square brackets are 
required syntax. This is the UIC under which the task is 
requested. It determines which files the task may access. The 
default is the value established for terminal CO:. 

Format 2 
Run at a time increment from the system image time 
RUN taskname dtime [/RSI=magu] [/UIC=[{uic]] 

Parameters 

taskname 


A l- to 6-character taskname. 


dtime 
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The time at which the task is initiated in time units from 
current system image time. It has the form: 


magu 


mag 


The magnitude 


Time units specified as follows: 


T 


M 


H 


for ticks. A tick is a clock interrupt, and the rate at 
which interrupts occur depends on the type of clock 
installed in the system. 


For a line frequency clock, the tick rate is either 50 or 
60 ticks per second, corresponding to the line frequency. 


For a programmable clock, a maximum o£ 1000 ticks’ per 
second is available. (The frequency is selected at system 
generation.) 
for seconds. 


for minutes. 


for hours. 


The magnitude is the number of units to be clocked, but the 
magnitude value cannot exceed 24 hours in specified units. 


RSI 


Units = T. Any Positive value is valid (maximum of 15 
bits). 

Units = S. Any Positive value is valid (maximum of 15 
bits). 

Units = M. The maximum magnitude is 1440(10). 

Units = H. The maximum magnitude is 24(10). 


See format 1, above. 


UIc 


See format 1, above. 


Format 3 


Run at a time increment from clock unit synchronization 


The task start-time is determined by computing the number of 


ticks 


until the next time unit's occurrence (hour, minute, 


second, tick) and then adding on the number of ticks for the 
specified time increment to elapse. 


RUN taskname sync [dtime] [/RSI=magu] [/UIC=[uic] ] 
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Parameters 
taskname 


A l- to 6-character taskname. 


sync 
H = synchronize on the next hour 
M = synchronize on the next minute 
S = synchronize on the next second 
T = synchronize on the next tick 
dtime 
Defined in format 2, above; dtime, if present, is added to the 
synchronization unit to produce the actual run time for running 
the task. 
RSI 
See format 1, above. 
UIC 
See format 1, above. 
Format 4 
run at an absolute time of day 
RUN taskname atime [/RSI=magu] [/UIC=[uic] ] 
Parameters 
taskname 
A 1- to 6-character taskname. 
atime 
The absolute time of day when this task will be initiated. Input 
format is hh:mm:ss. 
hh = hours (decimal assumed) 
mm = minutes (decimal assumed), and 
ss = seconds (decimal assumed). 
RSI 
See format 1, above. 
UIc 
See format 1, above. 
Examples 


>RUN XKE 15M 


Run task XKE 15 minutes from the current system image time. 


Note 
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>RUN XKE 15M/RSI=90S/UIC=[3,1] 


Run task XKE 15 minutes from the current system image time, 
rescheduling it every 90 seconds, with a UIC of [3,1]. 


The correct value to be inserted in the clock for forms 2 through 
4 is computed from the current value of the system time stored in 
the system image. Thus, the system image time must be set before 
any RUN requests are made or they may not occur at the correct 
time after the system is booted. 
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SAV 


SAVE 


Use the VMR SAVE command to write the image of a system onto a 
sequential medium in bootstrappable format. With this command you can 
copy an RSX-11S or a foreign system onto a tape or a floppy disk. You 
can then transport the tape or floppy to another computer and 
bootstrap it, using a hardware bootstrap or the /BO switch in PRESRV 
(refer to the description of the /IM switch in Section 8.2 of this 
chapter). 


System images created with the SAVE command on all media, except paper 
tape, are in a format compatible with the logical tape format in 
PRESRV. Thus, any of PRESRV's logical tape operations can be 
performed on system images created with the SAVE command. System 
images created by the SAVE command always start at the beginning of 
the medium. 


On paper tape, system images are created in absolute loader format and 
must be bootstrapped with the absolute loader. 


Format 

SAV[(E] ddnn: [label] 
Parameters 
ddnn: 


The device-unit onto which the system image is to be written. 
Valid devices are as follows. 


CT: Tape cassette 

DD: DECtape II 

DT: DECtape 

DX: Flexible diskette 
DY: RX02 floppy disk 

MM: TE/TU16/TU45 magtape 
MS: TSO4 magtape 

MT: TE/TU10/TSO3 magtape 
PP: Paper tape. 


label 
The file label name that must be specified for all secondary 
media except paper tape. It consists of from one to twelve 
alphanumeric characters. 
Example: 
VMR>SAV MT:MYSYS 
In this example, the system image is written onto MT: in 


bootstrappable format. System changes, made by other VMR 
commands, are also saved with the system image. 


Notes 
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When you use the /LI command in PRESRV to list the contents 
of a medium (other than paper tape) that contains one or more 
system images created with the SAVE command, each system 
image causes a line to be printed which contains the 
following: 


a. VW (for VMR), indicated as the source device 
b. The label specified in the SAV command line 
c. A block size of 512 


d. The number of 512-byte blocks in the system image 
{excluding boot and label blocks) 


e. The date and time that the system was saved 


When you save RSX-11S systems on paper tape and you do not 
apply the /IM switch to the system's file name, the last 
1000(8) bytes of the system image are not written out. This 
allows space to accommodate the absolute loader. When you 
specify the /IM switch with the system's file name, the 
entire system image is written out to paper tape. In this 
case, it is your responsibility to ensure that the system 
image is not so large that it overlays the Absolute Loader. 


When saving a system on paper tape, contiguous blocks’ that 
contain zero only and that begin on a 32-word address are 
compressed into a 2-word descriptor. This compression 
Significantly reduces both the amount of paper tape required 
and the time expended to create the tape and to read it into 
memory. After the entire image has been loaded into memory, 
a short routine zeroes the appropriate blocks of memory 
before passing control to the bootstrapped system. 


When bootstrapping systems on media other than paper tape, 
regardless of the size of the system image, the last 1000 (8) 
bytes of physical memory are not copied to accommodate the 
bootstrap. 


Systems saved on a TE/TU10/TS03, 9-track magtape drive can be 
booted from a TE/TU16 drive, and vice-versa, but not ona 
TSO4. 


When you specify the /IM switch with the system file 
specifier, the SAVE command always uses a bootstrap that does 
not enable memory management. 


The maximum memory size of a mapped system is 124K words. 
The SAVE command imposes maximum sizes on saved images in 
Mapped systems for certain devices. If a mapped system is 
saved, and its memory size is greater than the maximum size 
imposed by the SAVE command for the specified device, only 
the amount of memory equal to the maximum size (starting at 
physical location 0) is saved; no diagnostic message is 
issued, The devices for which the SAVE command imposes a 
maximum size on saved system images are: 


a. Paper tape punch (PP) - 28K words 


b. Flexible disk (DX) - 123K words 
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c. Flexible disk (DY) in single density - 123K words 


d. Cassette tape (CT) - 28K words 


None of the bootstraps require that the target RSX-11S system 
have a driver for the bootstrap device. 


The MM: drives are forced to 800 b.p.i. before 


writing to 
the tape. 
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SET 


SET 


You can use the SET command to alter a number of system-wide 
characteristics. The following list describes all the available 
options. The text in parentheses specifies keywords associated with 
the options. The SET command allows you to: 


e Display the status (determined by the keyword specified) for 
all terminals. 


e Establish device characteristics for any device in the system 
(BUF, CRT, ESCSEQ, LA30S, LOWER, REMOTE, SPEED...,). 


e Establish the default UIC for any terminal in the system 
(UIC). 


e Establish the system UIC used by the LOAD command and the 
Install~Run-Remove option of the RUN command, 


e Set the status of any terminal in the system (PRIV or SLAVE). 
e Create partitions 

e Add space to the system dynamic memory (POOL). 

@ Enable write check on devices that support it (WCHK). 


Improper use of the SET command can result in a situation in which the 
system will not accept privileged operator input. The following two 
situations should be avoided: 


e The system does not have any non-slave, privileged terminals. 
Non-privileged terminals cannot enter privileged commands. 
Slaved terminals cannot enter unsolicited input to MCR. See 
the description of the /SLAVE keyword below. 


@ The buffer length of all non-slave, privileged terminals is 
shorter than 14 bytes. In this case, the terminal buffer is 
too short to enter many important commands required to 
continue system operation or alter the status of other 
terminals. See the description of the /BUF keyword below. 


A number of SET command options (CRT, ESCSEQ, LOWER, and WCHK) require 
Executive features that must be included at system generation. If you 
specify an option which has not been generated into the system image, 
the SET command has no effect and results in an error. 


VMR permits only one keyword per command. You can prefix most 
keywords by NO to negate or disable the function of the keyword. 
Exceptions are BUF, HFILL, LINES, TERM, POOLSIZE, POOL, SPEED, UIC, 
and SYSUIC; VMR returns a syntax error when NO precedes one of these 
keywords. 

1 
Format 


SET /keyword=values 


Parameter 


/keyword=value 
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Either a device characteristics keyword or a memory allocation 
keyword. The device characteristics keywords are listed below: 


/BUF=dev: [size] 
/CRT [=dev: ] 
/ESCSEQ [=dev: ] 
/EBC [=dev: ] 

/ECHO [=dev: ] 

/FDX [=dev: ] 
/FORMFEED [=dev: ] 
/HFILL=dev: [value] 
/HHT [=dev: ] 
/LINES=dev: [value] 
/LOWER [=dev: ] 


/PRIV [=dev: ] 


/REMOTE [=dev:] 

/RPA [=devs ] 

/SLAVE [=dev: ] 
/SPEED=dev: [recv:xmit] 
/SYSUIC[=uic] 
/TERM=dev: [value] 
/TYPEAHEAD [=dev] 

/UIC [=uic[:dev:]] 
/VFILL [=dev: ] 

WCHK [=dev: ] 


/WRAP [=DEV:] 


The memory allocation keywords are listed below: 


BOT POOL 
PAR POOLSIZE 
NOPAR TOP 


Device Characteristics Keywords 


/BUF=dev: [size]. 


Sets or displays the default buffer size of the specified device. 
If you omit the buffer size, this keyword causes the current size 


to be displayed. 


less than or equal 


The size you specify must be greater than 0 and 
to 255 decimal (for a terminal, the buffer 


size must be greater than or equal to two). BUF is particularly 
useful for defining line printer width (80 or 132 columns). 


/CRT [=dev:], 


The dev: is not a cathode ray tube (CRT) terminal. The CRT 


keyword defines 
deletion option. 


the terminal as a CRT and enables the backspace 
When the backspace deletion option is enabled, 


typing the RUBOUT or DELETE key moves the printing position one 
Space to. the left and erases any character displayed in that 


position. 


When you omit the device 


specification, VMR displays all the 


devices that are defined as CRTs. 
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/NOCRT [=dev:], 


The dev: is a cathode ray tube (CTR) terminal. The NOCRT 
keyword deletes the CRT status of the specified device and 
disables the backspace deletion option. 


When you omit the device option, VMR displays all the terminals 
that are not defined as CRTs. 


/ESCSEQ [=dev:] 


The dev: is a terminal. The ESCSEQ keyword enables’ the 
recognition of escape sequences from the specified terminal. The 
terminal driver treats the ESC character as the beginning of an 
escape sequence rather than as a line terminator. See the 
RSX-11M I/O Drivers Reference Manual for further information 
about escape sequences. 


When you omit the device specification, VMR displays all _ the 
terminals that recognize escape sequences. 


/NOESCSEQ [=dev: ] 


The dev: is a_ terminal. The NOESCSEQ keyword disables’ the 
recognition of escape sequences at the specified terminal. 


When you omit the device option, VMR displays all the terminals 
that do not support the recognition of escape sequences. 


/EBC[=dev:], 


The dev: is a terminal. The EBC keyword enables the eight bit 
character option. The full duplex terminal driver will pass all 
8 bits of the input characters to the specified device. 


When you omit the device specification, the system will display 
the devices that have the eight bit character option enabled. 


/NOEBC [=dev:], 


The dev: is a terminal, The NOEBC keyword disables the eight 
bit character option. The full duplex terminal driver strips off 
the parity bits of the input characters before passing them _ to 
the device. 


When you omit the device specification, the system will display 
the devices that do not have the eight bit character option 
enabled. 


/ECHO[=dev:], 


The dev: is a terminal. The ECHO keyword enables the _ echo 
option. The full duplex terminal driver will display each 
character that is typed on the specified device. 


When you omit the device specification, the system will display 
the devices that, have the echo option enabled. 
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/NOECHO [=dev: ] 


The dev: is a terminal. The NOECHO keyword disables the echo 
option. The full duplex terminal driver will not display the 
characters that are typed on the terminal. 


When you omit the device specification, the system will display 
the devices that have the echo option disabled. 


/FDX [=dev:], 


The dev: is a terminal. The FDX keyword enbles the full duplex 
option. The full duplex terminal driver will accept input from 
the specified device while simultaneously outputing to it. 


When you omit the device specification, the system will display 
the devices that have the full duplex option enabled. 


/NOFDX [=dev:], 


The dev: is a terminal. The NOFDX keyword disables the full 
duplex option. The full duplex terminal driver will not process 
input and output from the specified device simultaneously. 


When you omit the device specification, the system will display 
the devices that do not have the full duplex option enabled. 


/FORMFEED [=dev:], 


The dev: is a terminal. The FORMFEED keyword indicates that the 
specified device has a hardware formfeed. 


When you omit the device specification, VMR will display the 
devices that have hardware formfeeds. 


/NOFORMFEED [=dev:], 


The dev: is a terminal. The NOFORMFEED keyword indicates that 
the specified device does not have a hardware formfeed. 


When you omit the device specification, VMR will display the 
devices on the system that do not have hardware formfeeds. 


HFILL=dev: [value] 


The value is a number between O and 7. The HFILL keyword 
specifies the number of file characters that the full duplex 
terminal driver is to place after a carriage return when 
outputing to the specified device. 


When you omit the value parameter, VMR will display the number of 
fill characters currently being output by the device driver to 
the specified device. 


/HHT (=dev:], 
The dev: is a terminal. Full duplex terminal driver only. The 
HHT keyword: indicates that the specified device has a hardware 
horizontal tab. 


When you omit the device specification, VMR will display the 
terminals on the system that have hardware horizontal tabs. 
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/NOHHT (=dev:], 


The dev: is a terminal. Full duplex terminal driver only. The 
NOHHT keyword indicates that the specified device does not have a 
horizontal tab. 


When you omit the device specification, VMR will display all of 
the terminals that do not have hardware horizontal tabs. 


/LINES=dev: [value], 


The value is a number between 1-255 that establishes the number 
of lines per page on the specified device. If you specify a 
number that is larger than the number of lines per page possible 
for a given device, VMR will default to the largest number 
possible for that device. 


When you do not specify a value, VMR will display the lines per 
page for the specified device. 


/ LOGON 


Enables logging onto terminals in a multiuser protection system. 


/NOLOGON 


Disables logging onto terminals in a multiuser protection system. 
LOGON and NOLOGON clear and set a flag checked by the HELLO 
command when a user attempts to log onto a_ terminal. This Set 
option provides a means of preventing users from accessing the 
system during system maintenance or account file maintenance 
activity, for example. 


/LOWER[=dev:], 


The dev; is a terminal. The LOWER keyword specifies that 
lower-case characters are not to be converted to upper case when 
they are received from the specified terminal. 


When you omit the device specification, VMR will display all 
terminals for which lower-case characters are not converted. 


/NOLOWER[=dev:], 


The dev: is a terminal. The NOLOWER keyword resets the terminal 
characteristics of the specified terminal so that lower-case 
characters received on input are automatically converted to upper 
case and echoed as upper case. 


When you omit the device specification, VMR will display all 
terminals for which conversion to upper case is specified. 


/PRIV [=dev:], 


The dev: is a terminal. The PRIV keyword sets the specified 
terminal to privileged status. 


When you omit the device specification, VMR will display all 
privileged terminals on the system. 


NOPRIV /NOPRIV[=dev:]. 


Sets the identified terminal to nonprivileged status. Absence of 
=dev: results in a display of all nonprivileged terminals. 
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/REMOTE [=dev:], 


The dev: is a terminal with a line to a DZ11 multiplexer. (The 
line can also be a DH11 with the full duplex terminal driver.) 
The REMOTE keyword declares that the specified terminal is 
connected to a modem and can therefore be connected to the system 
by means of a dial-up network. 


When you omit the device specification, VMR will display all 
remote lines (including DH1l1 lines). 


/NOREMOTE [=dev:], 


The dev: is a line to a DZ11 multiplexer. (The line can also be 
a DH11 with the full duplex terminal driver.) The NOREMOTE 
keyword establishes the terminal's line as a local line not 
connected to a modem. 


When you omit the device specification, VMR will display all 
local lines (including DL11, DH11, DJ11, and D211 multiplexers). 


/RPA[=dev:], 


The device is a terminal. The RPA keyword enables the 
read-pass-all option. The full duplex terminal driver will pass 
all characters input at the keyboard to the terminal's input 
buffer. 


When you omit the device specification, VMR will display all of 
the devices on the system that have the read-pass-all option 
enabled. 


/NORPA [=dev:], 


The dev: is a terminal. The NORPA key word disables’ the 
read-pass-all option. The full duplex terminal driver will not 
pass special function characters (for example CNTRL C) input at 
the keyboard to the terminal's input buffer. 


When you omit the device specification, VMR will display all the 
devices on the system that have the read-pass-all option 
disabled. 


/SLAVE [=dev: ] 
The dev: is a terminal. The keyword establishes the specified 
terminal as one that can enter data only if it is solicited from 
a task; thus, the specified terminal always rejects unsolicited 
input (other than CTRL/O, CTRL/Q, and CTRL/S). 


When you omit the device specification, VMR will display all 
terminals currently classified as slaved. 


/NOSLAVE [=dev:], 


The dev: is a terminal. The NOSLAVE keyword sets the specified 
terminal to nonslave status. 


When you omit the device specification, VMR will display all 
terminals currently classified as nonslave. 
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/SPEED=dev: [recv:xmit], 


The dev: is a terminal. The recv argument is the baud rate at 
which characters are input to the computer from the terminal. 
The xmit argument is the baud rate at which the computer outputs 
characters to the terminal. The SPEED keyword establishes the 
receive and transmit baud rate for terminals attached to the 
system through a DH11 or DZ1l1 multiplexer. You must specify both 
arguments when setting the speed. If you do not specify either 
VMR will display the current settings. 


Valid baud rates for the DH1l are: 0, 110, 150, 200, 300, 600, 
1200, 1800, 2400, 4800, 9600. A (user-specified baud rate A), 
and B (user-specified baud rate B). Valid baud rates for the 
DZ11 are: 0, 110, 150, 300, 600, 1200, 1800, 2000, 2400, 3600, 
4800, 7200, and 9600. The receive and transmit baud rates’ for 
the DZ1l must be the same; the DZ11 does not support split 
speeds, 


/SYSUIC[=uic], 


The uic has the format [g,m] and g and m are octal numbers’ that 
represent a group and member respectively. The /SYSUIC keyword 
establishes the UIC for the system and all system tasks. On most 
systems, the system UIC is [1,54]. These UIC values are the 
initial defaults on virgin systems. 


This UIC becomes the default UIC used by the Load command and the 
install-run-remove option of the Run command. 


When you omit the UIC specification, VMR will display the current 
UIC. 


/TERM=dev: [value], 


The dev: is a terminal and value is a RSX-11M supported terminal 
type. The TERM keyword establishes the terminal type of the 
specified device. When VMR_ sets’ the terminal type, it 
automatically sets the HFILL, VFILL, CRT, FORMFEED, and HHT 
characteristics for the terminal. The standard terminal types 
are as follows: 


ASR33 ASR35 KSR33 LA30P 
LA308 LA36 LA120 LA1808S 
VTO5B VT50 VT52 vT55 
vT6l VT100 


If you specify a terminal type that is unknown to VMR, VMR_ will 
not set any device characteristics for the terminal. However, 
VMR will store the value you have specified in the Unit Control 
Block (UCB). 


When you omit the value parameter, VMR will display the terminal 
type of the specified device. 


Note that VMR will also accept another form of the SET command, 
as follows: 


SET /term-type=dev: 
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term-type 

One of the standard terminal types listed above 
dev: 

An ASCII device name 


For example, SET /VT52=TT16: is equivalent to SET 
/TERM=TT16:VT52. 


/TYPEAHEAD [=dev:], 


The dev: is a_ terminal. The TYPEAHEAD keyword enables’ the 
TYPEAHEAD option for the specified device. The full duplex 
terminal driver will buffer input characters before passing them 
to a requesting task. Thus characters input during periods 
between requests will not be lost. 


/NOTYPEAHEAD [=dev:], 


The dev: is a terminal. The NOTYPEAHEAD keyword disables the 
TYPEAHEAD option for the specified device. The full duplex 
terminal driver will not buffer characters to prevent their loss. 


/UIC[=uic[:dev:]] 


The specified UIC is established as the default UIC for the 
entering terminal unless dev: is specified. If you specify 
dev:, the default UIC is set for that terminal. All tasks = run 
from the terminal are run with the UIC of the terminal, except in 
a multiuser protection system. In such a system, a _ privileged 
user can override the terminal UIC with the UIC switch in the RUN 
command. Further, external MCR’ function tasks! are requested 
with this UIC. 


When you do not specify uic (SET /UIC), the current UIC is 
displayed. If only dev: is specified (SET /UIC:dev:), the UIC 
for the specified terminal is displayed. 


/VFILL[=dev:], 


The device is-a terminal. The VFILL keyword enables the vertical 
fill characters option for the specified device. The full duplex 
terminal driver will add 4 fill characters following each 
linefeed. 


When you omit the device specification, VMR will display all of 
the terminals on the system that have the VFILL option enabled. 


/NOVFILL[=dev:], 


The device is a_ terminal. The NOVFILL keyword disables’ the 
vertical fill characters option for the specified device. The 
full duplex terminal driver will not add any verticle file 
characters following linefeeds. 


When you omit the device specification, VMR will display all of 
the terminals on the system that do not have the VFILL option 
enabled. 


Seem 


1 hese tasks are the MCR MOUNT, INSTALL, DMO, and UFD commands 
(which run as tasks) and all system-supplied software. 
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/WCHK [=dev:], 


The WCHK keyword specifies for all Files-ll devices except DxX:, 
DY:, and ODL: and magnetic tape (MM:, MS:, and MT:) that all 
writes are to be followed by a write check. This feature 
provides high reliability for data transfers to the specified 
disk. Executive support for write check is a SYSGEN option and 
must be selected for this command to have any effect. 


When you omit the device specification, VMR displays all Files-11 
disk drives with write check enabled. 


/NOWCHK [=dev:], 


The NOWCHK keyword specifies that write check is to be disabled 
for the specified device. 


When you omit the device specification, VMR will display all 


disks that support write check, but that have write check 
disabled. 


/WRAP [=dev:], 


The device is a terminal. The WRAP keyword enables the 
wrap-around option for the specified device. The full duplex 
terminal driver will automatically generate a carriage 
return/linefeed sequence when the number of input characters 
exceeds the buffer size of the specified device. Both the 
carriage return and linefeed are transparent and do not appear in 
the input buffer. 


When you omit the device specification, VMR will display all of 
the terminals on the system that have the wrap-around options 
enabled. 

/NOWRAP [=dev: ] 
The device is a terminal. The NOWRAP keyword disables the wrap 
around option for the specified device. The full duplex terminal 
driver will not accept input characters beyond the input buffer 
size. 
When you omit the device specification, VMR will display all of 
the terminals on the system that have the wrap around option 
disabled. 

Example 


>SET /BUF=LP0: 
BUF=LP0:132. 


Displays the current buffer size of LPO: 
>SET /BUF=TT1:40. 

Set TTl: buffer size to 40(10). 
>SET /CRT=TT3: 


Enable the backspace deletion option on the display terminal 
TT3:. 
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>SET /CRT 
CRT=TT3: 


Display all terminals that support the backspace deletion option. 
>SET /ESCSEQ=TT3: 


Establish terminal TT3: as a terminal that can send escape 
sequences. 


>SET /ESCSEQ 
ESCSEQ=TT3: 


Display all terminals that can send escape sequences. 
>SET /NOESCSEQ=TT3: 
Disable support of escape sequences on TT3:. 
>SET /LA30S=TT2: 
>SET /LA30S 
LA30S=TTO: 
LA30S=TT2: 


Set TT2: as an LA30S. 
Display all LA30S terminals. 


>SET /PRIV=TTO: 

Set TTO0: to a privileged terminal. 
>SET /PRIV 
PRIV=TTO: 
PRIV=TT1: 

Display all privileged terminals. 
>SET /REMOTE=TT21: 


Set the terminal line corresponding to TT21: as a remote dial-in 
line. 


>SET /REMOTE 
REMOTE=TT1: 
REMOTE=TT2: 
REMOTE=TT3: 
REMOTE=TT4: 
REMOTE=TT21: 


Display all terminals that are currently set as remote dial-in 
lines. MTT1l:, TT2:, TT3:, and TT4: 


>SET /SLAVE=TT3: 
Set TT3: to a slave terminal. 
>SET /WCHK=DK1: 


Enable write check on DKl:. 
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Memory Allocation Keywords 


/BOT=pname:value, 


The pname is a 1- to 6-character alphanumeric partition name and 
value a number of 64-byte blocks. The BOT keyword directs VMR to 
move the bottom boundary of the specified system-controlled 
partition up or down the amount indicated by the value parameter. 
The BOT keyword modifies the bottom boundary of a partition even 
though it has tasks installed in it. If you contract a partition 
that contains an installed task or loaded driver, VMR displays a 
warning message; the task or driver may no longer fit in the 
partition. 


The value parameter can be supplied in five formats: 


+value 


Moves the bottom boundary up by the specified amount. Moving 
the bottom boundary up makes the partition smaller. 


NOTE 


You can supply the value in the same 
units as the base and size parameters in 
the MAIN keyword described below. 


-value 


Moves the bottom boundary down by the specified amount. 
Moving the bottom boundary down makes the partition larger. 


value 


Establishes the total partition size equal to the specified 
value by moving the bottom of the partition. 


+*or* 


Moves the bottom boundary up as far as possible. Note that 
using this format will cause the bottom boundary to move up to 
the bottom of the first fixed task or driver loaded into the 
partition at the time the BOT keyword is executed. If there 
is nothing loaded into the partition, it will assume a size of 
1 64-byte block. 


Moves the bottom boundary down as far as possible. Using this 
format will cause the bottom boundary of the partition to move 
down to the top boundary of the partition below it or to the 
top of the Executive if the effected partition is the lowest 
partition in memory. 


/MAIN=pname[:base:size:type] 


Establishes a main partition. 


pname 


The 1- to 6-character alphanumeric partition name. 


J 
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:base 


The physical base address of the partition specified as a 
number of 64-byte blocks. 


:size 
The size of the partition specified as a number of 64-byte 


blocks. The maximum size is 0 to 1920.K words for a task, 
common, or main partition. . 


stype 
SYS for a main partition, DEV for a common partition that maps 
the device registers, COM for a common partition, or TASK for 
a task partition. 


Main partitions are allocated for user tasks and loadable 
drivers. 


Device partitions are allocated for device commons which are used 
by tasks to access the device registers on the I/O page. 


You may enter base and size in any of the following formats; 


Format Calculated Value 

nnnn Octal (nnnn*100) 

nnnn. Decimal (nnnn.*64.) 
nnnKk Octal K (nnn*4000) 
nnn.Kk Decimal K (nnn.*2048.) 


nnnn is a number to which a multiplication factor is applied to 
determine the value used. Valid ranges of calculated values are: 


Octal 0<=base<177777 0<size<2000 
Decimal 0.<=base<65535 0.<size<1024, 
Octal K OK<=base<3777K OK<size<40K 
Decimal K 0.K<=base<2047.K 0.K<size<32.K 


For system controlled partitions, size may range from 0 to 1920.K 
or any valid representation of these limits. 


You can specify the base address of a partition through a 
wildcard (*) for TASK or SYS partitions in a mapped system. When 
you specify a wildcard (*), VMR creates a partition at the lowest 
address possible for a partition of the size you have specified. 


You can also ‘specify the size of a partition through a wildcard 
(*) for SYS partitions. When you specify the wildcard (*), VMR 
creates the largest possible partition starting at the base 
address you have specified in the base parameter. 


When you specify wildcards for both the base and size, VMR_ will 
create a partition that will completely fill the first gap in the 
existing partition layout. 


If you do not specify base, size, or type, VMR will display the 
values of these parameters for the named partition. If the named 
partition is a main task-controlled partition, VMR also displays 
the parameters of all its subpartitions. 
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/NOMAIN=pname 


SUB 


Eliminates a named partition from the system. The partition you 
specify will be eliminated from the list of partitions and the 
system. If any tasks or commons are installed in or attached to 
the partition, the partition will not be eliminated and VMR will 
generate an error message. 


is the keyword that establishes a subpartition. Subpartitions 
May only be established in user-controlled main partitions. 


mname 
is the 1- to 6-character main partition name. The 
subpartition being defined becomes a subpartition in the named 
main partition. 

:pname 
is the 1- to 6-character subpartition name. The subpartition 
being defined becomes a subpartition of the main partition 
specified in mname. 

:base 


is the physical base address of the subpartition, specified as 
a number of 64-byte blocks. 


:size 


is the size of the subpartition, specified as a number of 
64-byte blocks. 


Base and size may be entered in any of the following formats; 
nmnnn is a number to which a multiplication factor is applied to 
determine the value used, 


Format Calculated Value 

nnnn Octal (nnnn*100) 

nnnn. Decimal (nnnn.*64.) 
nnnk Octal K (nnn*4000) 
nnn.K Decimal K (nnn.*2048.) 


Valid ranges of values are: 


Octal 0<=base<10000 0<size<2000 
Decimal 0.<=base<4096, 0.<size<1024, 
Octal K OK<=base<200K OK<size<40K 


Decimal K 0.K<=base<2047.K 0O.K<size<32.K 
Example: 


Any of the following inputs for size will allocate a 2048. byte 
subpartition. 


40 
32. 
1K 
1.K 


If base and size are omitted, the current values will be 
displayed for the named subpartition. 
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NOSUB 


is the keyword that eliminates the named subpartition from the 
system. 


/POOL[=TOP ] 
Increases the size of the dynamic storage region. 


TOP 


The first location in memory used for partition allocation. 
You specify TOP in units of 64-byte blocks. You can specify 
it in octal or decimal. When you do not specify TOP, VMR 
displays the current top of memory, the size of the longest 
block of pool space in words, and the total number of words in 
the pool. The display's format is: 


POOL top:max:total 
where top is given in units of 64-byte blocks, and max and 
total are in decimal words. 


You can specify TOP as a wildcard (*). The wildcard directs VMR 
to supply the maximum amount of pool possible. Specify the 
wildcard as follows: SET /POOL=*. 


If more pool is requested than can be supplied, a warning message 
is printed, and the maximum amount of pool possible is supplied. 


/POOLSIZE [=value] 


This command allows you to specify a total amount of pool rather 
than a top address. If you do not specify a value, VMR will 
display the current top of memory, the size of the longest block 


of pool space in words, and the total number of words in the 
pool. 


/TOP=pname: value 


Where pname is a l- to 6-character alphanumeric partition name 
and value is a number of 64-byte blocks. The TOP keyword directs 
VMR to move the top boundary of the specified system-controlled 
partition up or down the amount indicated by the value parameter. 
The TOP keyword modifies the top boundary of a partition even if 
the partition has tasks installed in it. If you modify the 
partition so that it is too small to hold the tasks installed in 
it, VMR will display a warning message and modify the partition 
anyway. 


The value parameter can be supplied in five formats: 
+value 
Moves the top boundary up by the specified amount. Moving the 
top boundary up makes the partition larger. 
NOTE 
You can supply the value in the = same 


units as the base and size parameters in 
the PAR keyword described above. 
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-value 


Moves the top boundary down by the specified amount. Moving 
the top boundary down makes the partition smaller. 


value 


Establishes the total partition size equal to the specified 
value, 


+* or* 


Moves the top boundary up as far as_ possible. Using this 
format causes the top boundary to move to the bottom boundary 
of the partition above it or to the top of memory if the 
partition is the top partition in memory. 


Moves the top boundary down as far as_ possible. Using this 
format causes the top boundary to move down to the top of the 
first fixed task, driver, or common loaded into the partition 
at the time the TOP keyword is executed. If nothing is loaded 
into the partition, the partition assumes a size of 1 64-byte 
block. 


Examples 


>SET /MAIN=SYSPAR: 420:140:TASK 


Define a partition called SYSPAR whose base address is 42000(8) 
and whose length is 14000(8) bytes. 


>SET /MAIN=SYSPAR 
MAIN=SYSPAR:0420:0140: TASK 
SUB=SYSPAR:MCRPAR:0445:0056 


Display the parameters of the main partition SYSPAR and all of 
its subpartitions. 


>SET /NOMAIN=SYSPAR 
Eliminate main partition SYSPAR. 

SET /MAIN=GEN:1000:6000:SYS 
Define a main partition called GEN as a system-controlled 
partition whose base address is 100000(8) and whose length is 
600000(8) bytes. 

>SET /POOL=420 


Define the first location in memory for partition allocation (No 
user defined partition can begin below 42000(8)). 


>SET /POOL 
POOL=0420:150:430. 
The first available location for user partitions is 42000(8); 


the longest free block is 150. words, and the total of all pool 
space is 430. words. 


) 


d 


Notes 
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If a partition currently hosts installed tasks or loaded 
drivers, and a command (for example, /NOMAIN) attempts to 
eliminate the partition, VMR rejects the command. 


When you define a partition, the name must not already be 
defined as a partition. In addition, a main partition cannot 
overlap any other main partition. (An exception is for DEV 
partitions in the I/O page; these can overlap.) 


The numeric value convention (a number followed by a _ period 
(.) is eéxplicitly decimal) applies to all the SET command 
numeric values. 


The address specified with the POOL command must be lower 
than the base address of the first partition in the system 
with the exception of partition LDR for a resident loader, 
which is in the Executive; LDR for loadable Loader. 


Once you have allocated space to the dynamic storage region, 
you cannot recover the space for use in partitions (you 
cannot contract pool). 


If the last partition is system-controlled, its top address 
is modified by Save at boot time to reflect the actual top of 
physical memory of the hardware in use, 
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TAS 


TASKLIST 


Use the TASKLIST command to display a description of each installed 
task in the system. The display contains in columnar form, from left 
to right: 


1. Task name 

2. Task version identification 

3. Task Control Block (TCB) address 

4. Partition name 

5. Task priority 

6. Size of task in bytes (octal) 

7. Load device identification 

8. Disk address logical block number (octal) in a virgin system, 

and the image or task file identification in a saved system 
image 

9. Task memory state 
Format 

TAS [KLIST] 
Example 
VMR> TAS 
«+eLDR 10 115450 LDRPAR 248. 00002400 LBO:- FILE 1D: (2177,15) FIXED 
TKTN 03.94 113400 TKNPAR 248. 00010000 LBO:- FILE ID: (2247,14) 
MCR... 02.01 114300 SYSPAR 160. 00010000 LBO:- FILE ID: (2234,15) 
«+eMCR Ol 112500 GEN 160. 00012000 LBO:- FILE ID: (2251,14) 
F11ACP M0320 115200 GEN 149. 00024000 LBO:- FILE ID: (2252,14) 
DBOFCP M0320 115100 GEN 149. 00063500 LBO:- FILE ID: (15221,124) 
«..DMO 22.00 114700 GEN 140. 00040000 LBO:- FILE ID: (2230,14) 
e«eINI 20.01 114500 GEN 140. 00040000 LBO:- FILE ID: (2232,14) 


««eMOU 22.15 114200 GEN 140. 00040000 LBO:- FILE ID: (2240,14) 
»»UFD V0410 113700 GEN 140. 00040000 LBO:- FILE ID: (2246,14) 


PMD... 04 113300 GEN 130. 00020000 LBO:- FILE ID: (3775,30) 
SHF... 04 113200 SYSPAR 105. 00010000 LBO:- FILE ID: (3256,546) 
---INS 04 114400 GEN 100. 00040000 LBO:- FILE ID: (2231,14) 
~+eSAV 04.22 114100 GEN 100. 00040000 LBO:- FILE ID: (2237,14) 
-.-BAD 05 112600 GEN 100. 00137700 LBO:- FILE ID: (1462,23) 
ooeAT. 04.24 114600 GEN 65. 00057700 LBO:- FILE ID: (1467,15) 
-»-BOO 03.4 115000 GEN 50. 00040000 LBO:- FILE ID: (2226,14) 
-» ACS Ol 113600 GEN 50. 00040000 LBO:- FILE ID: (2224,14) 
LPINIT Ol 113500 GEN 50. 00015500 LBO:- FILE ID: (4346,32) 
ooePIP M1332 113100 GEN 50. 00054200 LBO:- FILE ID: (1511,15) 
-»-LOA 03.3 113000 GEN 50. 00040000 LBO:- FILE ID: (2233,15) 
-.-UNL 02.8 112700 GEN 50. 00040000 LBO:- FILE ID: (2250,14) 
VMR> 
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On a system image generated for a PDP-11/70 with more than 124K 
words of memory, the size field (fifth column) contains 8-digit 
rather than 6-digit numbers. This display is for a virgin system 
image. 


FIXED indicates that the task is fixed in memory. 


VMR>TAS 
- LDR. LDR 248. 000000 LBO:- FILE ID:(0,0) FIXED 
TKTN SYSPAR 248. 010000 LBO:- FILE ID: (2572,11) 


««eMCR SYSPAR 160. 010000 LBO:- FILE ID: (2563,11) 
02 e5YS GEN 160. 010000 LBO:- FILE ID:(2565,11) 
F11ACP FCPAR 149. 026000 LBO:- FILE ID: (2576,11) 
» « «DMO GEN 140. 040000 LBO:- FILE ID: (2556,11) 
«INT GEN 140. 040000 LBO:- FILE ID: (2557,11) 
+ »MOU GEN 140. 040000 LBO:- FILE ID: (2567,11) 
-» UFD GEN 140. 040000 LBO:- FILE ID: (2573,11) 
PMD... PMDPAR 130. 020000 LBO:- FILE ID: (2610.12) 
SHF... SYSPAR 105. 010000 LBO:- FILE ID: (2606,11) 
«-eINS GEN 100. 040000 LBO:- FILE ID; (2562,11) 
«2 SAV GEN 100. 040000 LBO:- FILE ID: (2570,11) 
- « «BAD GEN 100. 040000 LBO:- FILE ID: (6162,34) 
PRT... PMDPR 70. 020000 LBO:- FILE ID: (5210,6) 


» « BOO GEN 50. 040000 LBO:- FILE ID: (2273,30) 
2 ACS GEN 50. 040000 LBO:— FILE ID: (1066,22) 
»+ePIP GEN 50. 054300 LBO:- FILE ID: (2627,11) 
«-ePSE GEN 50. 031600 LBO:- FILE ID: (5552,4) 
» + AT. GEN 1. 040000 LBO:- FILE ID: (5013,4) 


The preceding display is from a saved system. It differs from a 
virgin system in that the file ID of the task file, rather than 
the logical block number, is displayed. 


TIM 


TIME 
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Use the TIME command to set the time of day and the date, or to 
display the time and date. 


Formats 


TIM(E] (hrs:mins[:secs]] [ml/day/year] 


or 


TIM[E] [hrs:mins[:secs]] [day-m2-year] 


Parameters 
hrs Hours (range 0 through 23). 
mins Minutes (range 0 through 59). 
secs Seconds (range 0 through 59); this parameter is 
optional. 
ml Numeric representation of month (range 1 through 12). 
m2 Three-letter abbreviation for month. 
day Day (range 1 through 31). 
year Year (range 0 through 99). Year is relative to 1900; 
thus, 1977 is entered as 77. 
Examples 
>TIM 


Notes 


10:23:31 03-MAY-79 


Display the current system image time and date. 


>TIM 1:30 5/3/79 


Set the time to 01:30:00 and the date to 03-MAY-79 


If you specify neither time nor date, VMR displays the 
current system image time and date. 


If you specify the time and date, VMR sets the system image 
clock and calendar. If you specify only the time, VMR sets 


only the clock; if you specify only the date, VMR sets’ only 
the calendar. 


You can specify the time and date in any order. 


All numeric values are decimal. No terminating period is 
used. 
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UNF 


UNFIX 


Use the UNFIX command to free a fixed task from the system image. 
UNFIX is the complement of the FIX command. 


If a fixed task exits or aborts, it still occupies the system image 
memory of the partition. 


Format 
UNF [IX] taskname 
Parameter 
taskname 
The task that you wish to unfix in memory. 
Example 
>UNFIX XKE 


Unfix task XKE, freeing the partition in which it resides. 
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UNL 


UNLOAD 


Use the UNLOAD command to remove a loadable device driver from the 
system image. If a device is attached, its driver cannot be unloaded. 


To unload a device driver from the system image, the driver's STB file 
must reside on the same disk and under the UFD that corresponds to the 
UIC of the system image file. 


The UNLOAD command cannot remove a data base from the system image, 
even if the data base was loaded by means of the LOAD command. 


Format 
UNL[OAD] dd: 
Parameter 
dd: 
A 2-character ASCII device name 
Example 


VMR>UNL LS: !UNLOAD LPS11 DRIVER (LSDRV) 
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8.6 VMR ERROR MESSAGES 


Following are the VMR command error messages. When a VMR- error 
message applies to more than one command, the applicable command is 
indicated above the associated message description. 


VMR -~ ADDRESSING EXTENSIONS NOT SUPPORTED 


INSTALL 
You are trying to install a task that was built using the VSECT 
(Virtual section) directive into a system image that does not 
Support the VSECT feature. 


VMR -- ALIGNMENT ERROR 


The base address or size of the partition you are attempting to 
create conflicts with existing partitions or physical memory. 


VMR -- BASE ADDRESS MUST BE ON A 4K BOUNDARY 


INSTALL 
The virtual base address of your task is not aligned on a 4k 
boundary. 


VMR -- BASE MISMATCH COMMON BLOCK <common-name> 


INSTALL 
The base address of the partition does not match that of the 
common block. Applicable to unmapped system images only. 


VMR -- CANNOT FIX A TASK IN A SYSTEM CONTROLLED PARTITION 


FIX 
This is a VMR restriction. To fix a task in a system-controlled 
partition, use the MCR Fix command and then save the system 
image. 


VMR -- CANNOT INSTALL TASKS FROM OTHER THAN LB: 


INSTALL 
When you SAVE a system, SAVE deletes from the system image all 
tasks and commons that were not installed from the library device 
LB:. Therefore, you cannot install a task or a common from other 
than LB:. 


VMR -- CANNOT LOAD/UNLOAD A PSEUDO DEVICE 


LOAD AND UNLOAD 
The device name you specified was that of a pseudo device. 
Pseudo devices cannot be loaded or unloaded. 


VMR -- CHECKPOINT AREA TOO SMALL 


INSTALL 
The area you have allocated for checkpointing in your task image 
file is smaller than the partition into which you are attempting 
to install your task. The system image does not support’ the 
dynamic allocation of checkpoint space. 
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~- CHECKPOINT SPACE TOO SMALL, USING CHECKPOINT FILE 


INSTALL 

This is a warning message. The checkpoint space you have 
allocated in your task image file is too small to hold your task 
(usually because of the /INC keyword). The system image supports 
the dynamic allocation of checkpoint space. It will use the 
checkpoint file to store your task when it rolls it out to disk. 
Since no checkpoint file exists when you boot your system, you 
should consider this message to be a fatal error if it is issued 
by any of the system tasks during the boot. These tasks are MCR, 
MOU, SAV, and F1I1ACP. 


-- CIRCULAR REDIRECT ERROR 


REDIRECT 
Your attempt to redirect a device has failed because it would 
result in a circular device list. 
-- COMMAND I/O ERROR 


The system has detected an I/0 error during a read from an 
indirect file. 


-- COMMAND SYNTAX ERROR command line 
The syntax of the printed command line is incorrect. 
-- COMMON BLOCK CURRENTLY INSTALLED 
INSTALL 
You are attempting to install a common block that has already 
been installed. 


-- COMMON BLOCK IS A TASK PARTITION common-name 


INSTALL 
A task's request for access to a common block has been rejected 
because the requested partition is a task partition. 


-- COMMON BLOCK NOT LOADED common-name 


INSTALL 
The common block specified by VMR in the error message has been 
linked to your’ task but it has not been installed. The common 
block must be installed before your task can be installed. 


—-- COMMON BLOCK OCCUPIED 


INSTALL 
An attempt was made to load a common block that was occupied. 


-- COMMON BLOCK PARAMETER MISMATCH common-name 


INSTALL 
The parameters of the common block named in the error message do 


not match the parameters in the label block of the task that 
references the common. 


-~- COMMON BLOCK SEGMENT COUNT ERROR 
INSTALL 
The command attempted to install a resident library with 


overlays, but the number of overlay segments in the task header 
differs from the number specified in the segment descriptors. 


8-54 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR COMMANDS 


-- DEVICE ddn: IS ATTACHED 


UNLOAD 
You are attempting to unload a driver that has one or more of its 
device units attached. The first attached unit is ddn:. You 
cannot unload a driver that has device units attached. 


-- DEVICE ddns NOT IN SYSTEM 


DEVICES 
The device you requested in the Device command does not exist in 
the system image. 


SAVE 
You are attempting to save an image on a device that does not 
exist on your host system. 


REDIRECT 
You are attempting to redirect I/O requests to a device that does 
not exist on your host system. 


LOAD AND UNLOAD 
You have specified a device in your load command for which’ there 
is no data base. This is caused by one of two conditions: 


1. The device does not exist in the system device tables, 
2. The driver file does not contain a loadable data base. 


INSTALL 
You have specified a device in your INSTALL command that has not 
been defined in the system image, 


-- DEVICE NOT MOUNTED 


You have not mounted the device that contains the system image 
file. 


-- DEVICE NOT REDIRECTABLE 


REDIRECT 
The specified device cannot be redirected. 


-- DRIVER ALREADY RESIDENT 


LOAD 
You have specified a device driver that is already loaded or that 
is permanently resident in the system image. 


-- DRIVER BUILT WITH WRONG STB FILE 


LOAD 
The symbol definition file for the driver is not compatible with 
the Executive symbol definition file for the current system 
image. This means that your driver has been built for another 
system and must be rebuilt before you can load it into the 
current system. 


UNLOAD 
The symbol definition file for the driver is not compatible with 
the symbol definition file of the current Executive. This 
probably means that the most recent copy of the driver is built 
for another Executive. If they exist, try making older versions 
of the driver have the highest file sequence number. 
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-- DEVICE NOT TERMINAL 


SET 
You have attempted to set terminal characteristics for a 
nonterminal device. 


-- DEVICE NOT VARIABLE SPEED MULTIPLEXER 


SET 
You have attempted to set the baud rate for a terminal that is 
not attached to a DH11 or DZ1l1l multiplexer. 


-- DRIVER CANNOT BE UNLOADED 


UNLOAD 
You have attempted to unload a permanently resident driver (that 
is, a driver linked to the Executive). 


-- DRIVER NOT LOADED 


UNLOAD 
You have specified a driver in your UNLOAD command that is not 
resident in memory. 


-- DRIVER REQUIRES RUNNING SYSTEM FOR LOAD/UNLOAD 


LOAD 
The driver you have requested has the symbols SddLOA or S$ddUNL in 
its source. RSX-11M does not support those calls. Note however, 
that these symbols are reserved for future use by the MCR _ LOAD 
and UNLOAD commands. 


-- EXECUTIVE IS TOO LARGE 


Your Executive is too large to be accommodated in the system 
image. If your Executive is larger than 16K words, this message 
indicates that you have not included 20K Executive support during 
SYSGEN. If you did include support for a 20K Executive, this 
message indicates that the Executive is larger than 20K. In 
either case, the system is unusable. 


-- FILE name HAS ILLEGAL FORMAT 


LOAD 
Your driver's symbol definition file contains illegal object code 
or data. 


-- FILE name HAS INCONSISTENT DATA 


FIX-IN-MEMORY 
You are attempting to fix a partition or a task that is logically 
beyond the end of the system image file. 


LOAD 
The partition for loadable drivers is logically beyond the end of 
the system image file. 


Your driver task does not conform to the loadable driver 
guidelines or the driver has an invalid loadable data base. 
(Refer to RSX-11M Guide to Writing an I/O Driver.) 


INSTALL 
The partition of the common library you are attempting to load is 
logically beyond the end of the system image file. 


VMR COMMANDS 


VMR ~-- FILE name NOT A VALID DRIVER TASK IMAGE 
One of three things has occurred: 
1. Your driver's task image has been overlaid, 
2. Your driver has a header, 
3. Your driver has referenced a resident library. 
VMR -- FILE NOT CONTIGUOUS 
INSTALL 
You have attempted to install a task from a noncontiguous file. 
Task images must be contiguous files. 
LOAD 
The file ddDRV.TSK is not contiguous. This file must be 
contiguous. 


VMR -- FILE NOT FOUND 


You have requested a file that is not in the UFD of the volume 
you have specified. 


VMR -- FILE NOT TASK IMAGE 
INSTALL 
The data in the label block of your task is incorrect, indicating 
that your file is not a task image. 
VMR -- ILLEGAL DEVICE/VOLUME 
SAVE 
You have attempted to save your system image on an invalid 
device. Valid devices are: 
CT: Tape cassette 
DD: DECtape II 
DT: DECtape 
DX: Flexible diskette 
DY: RX02 floppy disk 
MM: TE/TU16/TU45 magnetic tape 
MS: TS04 magtape 
MT: TE/TU10/TSO3 magnetic tape 
PP: Paper tape 
VMR -- ILLEGAL DRIVER TASK APR USAGE 
LOAD 
Your device driver must be built for APR 5 (addresses must’ start 
at 120,000). 
VMR -- ILLEGAL ERROR SEVERITY CODE code 
This message indicates an internal failure in VMR. If this error 


message persists, contact a Digital software representative. 
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VMR COMMANDS 


VMR -~ ILLEGAL FILE SPECIFICATION file specification 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


The file specification printed following the error message has an 
illegal format or contains wild card specifiers. 


~- ILLEGAL FIRST APR 
INSTALL 
You have builIt your task using an incorrect base APR. The 
following rules apply: 


1. A nonprivileged task must be built with APR 0 as its base 
APR. 


2. A privileged task that wishes to map the Executive routines 
and data structures must be built with APR 4 as its base APR 
if the Executive is 16K words or less. 

3. A privileged task that wishes to map the Executive routines 
and data structures must be built with APR 5 as its base APR 
if the Executive is 20K words or less. 


4. A privileged task that does not map into the Executive must 
be built with APR 0 as its base APR. 


-- ILLEGAL FUNCTION 
You have entered a command that VMR does not recognize. 
-- ILLEGAL GET COMMAND LINE ERROR CODE 


This error indicates a system failure. If this message persists, 
contact a Digital software representative. 


-- ILLEGAL KEYWORD VALUE 
You have entered a value for a keyword that exceeds its limits. 
-- ILLEGAL OPERATION FOR UNMAPPED SYSTEM 
SET 
The specified keyword (/POOLSIZE) is valid in mapped systems 
only. 
-- ILLEGAL PRIORITY 


INSTALL AND ALTER 
You have specified a priority that is out of range (that is, not 
1 to 250(10), inclusive). 


-- ILLEGAL SWITCH /switch 


The switch printed following the error message is incorrect in 
the context of the command line you have entered. 


-- ILLEGAL USE OF WILDCARD 


SET 
In an unmapped system, specification of a wildcard (*) with the 
/TOP, /BOT, and /POOL keywords is not permitted. Also, you 
cannot specify a wildcard for the "size" parameter with task 
partitions. 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 
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-- ILLEGAL VALUE FOR SYMBOL symname IN FILE name 


LOAD AND UNLOAD 

LOAD or UNLOAD has determined that symbol symname in the STB file 
name has been defined to an illegal value. This can occur for 
several reasons, some general and some specific to individual 
symbols. For example, in general, most symbols cannot be defined 
to zero or to an odd number. A specific example is the symbol 
SINTSV. SINTSV must not be referenced by mapped loadable 
drivers. 


-- INCORRECT ASSIGNMENT OF SY: OR LB: 

This is a warning message. The device, SY: and LB: are not 
assigned to the same device as the system image file you are 
attempting to VMR. 

~- INDIRECT COMMAND SYNTAX ERROR command line 

You have entered an improper indirect command file specifier. 


~- INDIRECT FILE DEPTH EXCEEDED command line 


You have attempted to exceed more than two levels of indirect 
files. 


-- INDIRECT FILE OPEN FAILURE command line 


The indirect command file in the printed command line could not 
be opened. 


-- INSTALL DEVICE NOT LBO: 


INSTALL 
You have attempted to install a task from other than the boot 
device. 


-- INSTALLED TASKS MAY NO LONGER FIT IN PARTITIONS 


SET 
You have shortened a partition so that the tasks that are 
installed in it may no longer fit. This is a warning message. 
VMR will shorten the partition even though this situation exists. 


-- INTERRUPT VECTOR ALREADY IN USE 


LOAD 
LOAD has determined that your interrupt vector does not point to 
one of the nonsense interrupt entries in the system image. This 
usually means that another driver is using the interrupt vector. 


-- INVALID DRIVER DATA BASE AT OFFSET xxxx IN FILE name 


LOAD 
The driver name has an invalid data base value at offset xXxxx 
relative to the symbol $ddDAT. 


-- INVALID INTERRUPT VECTOR 
LOAD 


You have specified an interrupt vector address in your driver 
data base that is too high for the current system image. 


VMR COMMANDS 


VMR -- INVALID KEYWORD 


You have specified a keyword that is incorrect in the context of 
your command. 


VMR -- INVALID RECORD ADDRESS FOR FILE name 
ANY COMMAND 
The command has attempted to write outside of the system image 
file or at a byte boundary. Two possible causes are: 
1. <A corrupted system image or 
2. An STB file that does not match the system image. 
VMR -- INVALID SPEED 


SET 
This message can be caused by two things: 


1. You have requested a speed that the multiplexer line you have 
specified does not support. 


2. You have specified unequal receive and transmit speeds for a 
DZ11. The DZ11 does not support split speeds. 


VMR -- INVALID TIME PARAMETER 


RUN 
The date or time field you have specified is incorrect. 


VMR -- INVALID UIC 


You have specified an illegal value for either a group number or 
a member number. 


VMR -- I/O ERROR ON INPUT FILE filename 
An input I/O error occurred on the indicated file. 
VMR -- I/O ERROR ON OUTPUT DEVICE 
SAVE 
SAVE has encountered an I/O error on the output device while 
writing the system image. 
VMR -- I/O ERROR ON OUTPUT FILE filename 
An output I/O error occurred on the indicated file. 
VMR —- KEYWORD NOT SUPPORTED FOR THIS TERMINAL DRIVER 
SET 
The terminal driver specified during SYSGEN does not support the 
specified keyword (for example, typeahead is a full duplex 


terminal driver option only and your system contains the half ~- 
duplex driver). 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR COMMANDS 


-- LENGTH MISMATCH COMMON BLOCK blockname 


INSTALL 
The length parameter for the common block, as described in the 
label block for the task image, does not match the corresponding 
length parameter defined in the system image. A task's label 
block data must match system data for that task before it can be 
installed. 


-- LINE NOT D@1l 


SET 
You have attempted to set a line to remote that is not attached 
to a DZ1l and your system contains the half duplex terminal 
driver. 


-- LOADABLE DRIVER SUPPORT NOT IN SYSTEM 


LOAD AND UNLOAD 
You have attempted to load a device into or unload a device from 
a system image that does not support loadable device drivers. 


-~ LOGICAL DEVICE NOT IN SYSTEM 


ASSIGN 
The device you have specified has not been defined and therefore 
ASSIGN cannot find it in the logical device assignment table. 


-- LUN OUT OF RANGE 


REASSIGN 
You have attempted to reassign a LUN number that is higher than 
the maximum number of LUNS that you allocated at task build. 


-- NO CHECKPOINT SPACE, ASSUMING NOT CHECKPOINTABLE 


- INSTALL 
This is a warning message. You have attempted to install a_ task 
as checkpointable that you have not built as checkpointable. 
This means that there is no checkpoint space allocated in the 
task image file. Since your system does not support the dynamic 
allocation of checkpoint space, INSTALL does not consider’ the 
task to be checkpointable. 


-- NO LUNS 


LUN 
The task that you have specified as an argument of the LUN 
command does not have any logical units assigned to it. This is 
not an error message; rather, it is simply an indication that 
there are no assignments to display. 


-- NO POOL SPACE 
LOAD 
The pool space required by the driver is not available in the 
system image. 


-- NON EXISTENT MEMORY 


SET 
You have attempted to define a partition in nonexistent memory. 
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VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 
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-- NOT ENOUGH APRS FOR TASK IMAGE 


INSTALL 
The Task Builder allows you to specify the virtual base address 
of a task image as a multiple of 4K, Privileged tasks that 
access the Executive start at either virtual 100000(8) or at 
120000(8) depending on the size of the Executive. If the virtual 
base address of the task is set too high, there will not be 
enough APRS remaining to map the task image. (Refer to the 


RSX-11M/M-PLUS Task Builder Manual for information on privileged 
tasks.) 
-- OLD DEVICE ATTACHED 


REDIRECT 
You have attempted to redirect an attached device. 


-- OPEN FAILURE ON FILE filename 
The indicated file cannot be opened. 
-~ PARTITION ALREADY EXISTS 
SET 
You have attempted to define a partition with a name already in 
use, 
-- PARTITION IS BUSY 
LOAD 
The partition into which you attempted to load your driver is 


full, therefore, your task cannot be loaded. 


FIX 
You have attempted to fix a task or common region partition that 
is full, therefore the task cannot be fixed. 


-- PARTITION name IS A COMMON 


LOAD 
You have attempted to load a device driver into a common 
partition. A device driver cannot be loaded into a common 
partition. 


-- PARTITION pname IS NOT A COMMON 


LOAD 
Partition xxCOM was found, but it is not a common partition. 


-- PARTITION pname NOT IN SYSTEM 


LOAD 
You are attempting to load a driver into a partition that does 
not exist in the system or LOAD found a symbol $xxCOM in the 
driver and partition xxCOM does not exist in the system. 


-- PARTITION pname IS TOO SMALL 
INSTALL 


You are attempting to install a task that is too large for the 
partition you have specified. 


VMR 
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VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 
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-- PARTITION NOT COMMON 


INSTALL 
A partition specified for a common area or library is not defined 
as a common partition. 


-- PARTITION NOT IN SYSTEM 


LOAD 
The partition you have specified is not in the system image. 


-- PARTITION NOT SYSTEM CONTROLLED 


SET 
The /TOP and /BOT keywords are valid for system controlled 
partitions only. 


-- PARTITION par NOT IN SYSTEM, DEFAULTING TO GEN 


INSTALL 
This is a warning message. You have attempted to install a task 
in a partition that does not exist. VMR will attempt to install 
the task in the partition GEN. 


~- PRIVILEGED TASK LARGER THAN 12K 


INSTALL 
You have attempted to install a privileged task that is larger 


than 12K words. (Refer to the RSX-11M/M-PLUS Task Builder Manual 


for information on privileged tasks.) 
-- POOL LINK ERROR AT xXxxx BLOCK=yyyy 222z 
SET 
When SET /POOL traced the pool linkage, it detected an error at 
location xxxx in the system image. The contents of xxxx is yyyy 
and the contents of xxxx+2 iS zzzz. 


-- PSEUDO DEVICE ASSIGNMENT ERROR 


ASSIGN 
You have attempted to assign a logical device name to a _ pseudo 
device. Logical device names cannot be assigned to pseudo 


devices. 
-- PSEUDO DEVICE REDIRECT ERROR 


REDXRECT 
You have attempted to redirect one pseudo device to another 
pseudo device. 


-- RECEIVE DATA OR BY REFERENCE LIST NOT EMPTY 


REMOVE 
A task with entries in its receive queues cannot be removed from 
the system image. 


-- SPACE USED 
SET 


You have attempted to create a partition in a storage area that 
is already occupied. 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 
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-- SPECIFIED PARTITION FOR COMMON BLOCK 


INSTALL | ‘ 
You are attempting to install a task into a common block. 


-- SPECIFIED PARTITION TOO SMALL 
INSTALL 


You are attempting to install a task into a partition that is 
smaller than the task. 


LOAD 
You are attempting to install a driver into a partition that is 
smaller than the driver. 
-- SYMBOL symname IS DOUBLY DEFINED BY FILE name 
LOAD AND UNLOAD 
The symbol symname is defined twice in file name. Duplicate 
symbols are illegal. 
-- SYMBOL symname IS UNDEFINED IN FILE name 
LOAD AND UNLOAD 
LOAD found the symbol symname in the file name, but the symbol is 
not defined. 
-- SYNTAX ERROR 
You have typed the command incorrectly. 
-- SYSTEM IMAGE IS RSX-11M-PLUS 


You are attempting to use VMR on an RSX-11M-PLUS system image 
file. This will not work and is not permitted. 


-- TASK ACTIVE 


The task you have specified as an argument of your command is 
active. 


~- TASK ALREADY FIXED 
FIX 


You have attempted to fix a task in memory that is already fixed 
in memory. 


- TASK AND PARTITION BASES MISMATCH 
INSTALL 
The base of the partition does not match that of the task being 
installed. Applicable to unmapped system images only. 
-- TASK IS CHECKPOINTABLE 
FIX 


You have attempted to fix a checkpointable task in memory. 
Checkpointable tasks cannot be fixed in memory. 


i 
> 


VMR COMMANDS 


VMR -- TASK IMAGE CURRENTLY INSTALLED 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


INSTALL 
You are attempting to install a checkpointable task that has 
checkpoint space allocated in its task image. The task has 
already been installed. The system will allow you to install 
checkpointable tasks more than once subject to the following 
rules: 


1. You muSt allocate checkpoint space for your task in a system 
checkpoint file. 


2. You must use a different name for your task each time you 
install it. 


-- TASK IMAGE I/O ERROR 


INSTALL 
Your device is write-locked. VMR could not read the task-image 
file or could not rewrite the task image header. 


-- TASK IMAGE VIRTUAL ADDRESS OVERLAPS COMMON BLOCK block-name 
INSTALL 
The virtual addresses you have reserved for the task image 
overlap those you have reserved for the common block specified in 


the error message. Corruption of the task image file may have 
caused the overlap. 


-- TASK NAME ALREADY IN USE 

INSTALL 
You have attempted to install a task of the same name as_ one 
already in the system image. 


-- TASK NOT FIXED 


UNFIX 
You have attempted to unfix a task that is not fixed in memory. 


-- TASK NOT IN SYSTEM 


You have referenced a task that you have not installed in the 
system. 


~- TI REDIRECT ERROR 


You have attempted to redirect the pseudo device TI:. TI: 
cannot be redirected. 


~- TOO MANY COMMON BLOCK REQUESTS 


INSTALL 
You are attempting to install a task that contains too many 
common-block requests. A task is limited to seven common block 
references, 


-~ TOO MANY LUNS 
INSTALL 


You are attempting to install a task that contains more than 
255(10) LUN assignment requests. 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 
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-- TOP OF POOL SET TO value, REQUESTED AMOUNT NOT AVAILABLE 


SET 
You have requested more pool space than the system can _ provide, 
so the maximum amount was used. This is a warning message. 


-- UNDEFINED COMMON BLOCK block-name 


INSTALL 
You are attempting to install a task that references a common 
block that is not defined in the system image. This message may 
indicate that the task was built for another system. 


-- UNKNOWN MAIN PARTITION 


You are attempting an operation on a main partition which does 
not exist in the system. 


-- WARNING - LOADABLE DRIVER LARGER THAN 4K 


LOAD 
You are loading a driver that is larger than 4K words. This is a 
warning message. 


-- WARNING - PRIVILEGED TASK OVERMAPS I/O PAGE 


INSTALL 

A privileged task that is mapped into the Executive is often 
mapped to the I/O page as well. However, many privileged tasks 
do not require access to the I/O page and can use the extra 4K of 
address space that would be allocated to the I/O page for the 
task image. This message warns that a privileged task that may 
require access to the I/O page does not have that access. If 
your task does not require access to the I/O page, this message 
can be ignored. 


-- WRITE CHECK NOT SUPPORTED FOR DEVICE 


SET 
You have attempted to enable write check on a device that does 
not Support it. Write check is supported for all disks except 
DL:, DX:, and DY:. 


CHAPTER 9 


SYSGEN PHASE III 


This chapter lists and describes the questions in SYSGEN Phase III. 


9.1 DETAILS OF SYSGEN PHASE III 
Expanded comments for SYSGEN Phase III 


Expanded comments provide descriptions for SYSGEN Phase III 
questions. 


ARE YOU RUNNING ON A MACHINE WITH AT LEAST 24K WORDS 
If the current system has less than 24K-words of memory, the 


utility tasks cannot be built. SYSGEN displays the following 
message and the exits. 


SORRY, YOU CANNOT BUILD ANY UTILITIES AND/OR USER MODE 
DIAGNOSTICS WITH A MACHINE SMALLER THAN 24K WORDS! 


If your system has at least 24K-words, SYSGEN continues. 


ARE YOU BUILDING A MAPPED SYSTEM 


SYSGEN uses the response to this question to determine the 
correct system UIC ([1,50] for unmapped, [1,54] for mapped). 


DO YOU HAVE THE DUAL RKOS DISTRIBUTION KIT 
If you are using the dual. RKO5 kit, you must identify the RKOS5 
units that contain the baseline system disk (RSXM26) and the 
utility object files disk (UTLOBJ). SYSGEN asks the following 
two questions. 

IN WHICH DEVICE IS THE RSXM26 DISK MOUNTED (ddu:) 
Enter the RKO5 drive that contains the baseline system disk. 

IN WHICH DEVICE IS THE UTILOBJ DISK mounted (ddu:) 
Enter the RKO5S drive that contains the utility object files. 


SYSGEN then assigns the utility disk to the pseudo device SY: 
and the baseline system disk to the pseudo device LB:. 


SYSGEN PHASE III 


If you are not using the dual RKO5 kit, SYSGEN asks the following 
question. 


DO YOU HAVE THE RLO1 DISTRIBUTION KIT 
Enter No if you are using a big disk kit. 

ARE YOU RUNNING ON A MACHINE WITH A LINE PRINTER 

WAS ANSI MAGTAPE SUPPORT SELECTED IN SYSGEN PHASE I 

WAS USER MODE DIAGNOSTIC SUPPORT SELECTED IN SYSGEN PHASE I 
SYSGEN Phase III can build either utility tasks or user mode 
diagnostic tasks or both. The following questions determine 
further action (the second question does not appear if you 


respond No to this question). 


DO YOU WANT TO (RE)BUILD ANY UTILITY TASKS 
DO YOU WANT TO BUILD ANY USER MODE DIAGNOSTICS 


***UTILITY TASKS*** 


IN ORDER FOR THE UTILITY TASKS TO USE ANSI FORMAT TAPE 
THEY MUST BE BUILT WITH THE ANSI FCS ROUTINES. THESE 
ROUTINES MAY CAUSE CERTAIN TASKS TO INCREASE BEYOND THE 
NORMAL 8K SIZE. 


IF YOU WANT TO BUILD THE UTILITY TASKS WITH 
ANSI MAGTAPE SUPPORT, YOU HAVE TO EDIT THE TASK 
BUILD COMMAND FILES FOR THESE TASKS. 


me Me Me we NO Ne Me fe Ne we 


The task-build command file for a particular utility task 
has to be edited only if the task size turns out to be above 
8K words. This means that SYSGEN3 may have to be run a 
second time. 


MOST OF THE TASKS TO BE BUILT HAVE TASK BUILD 
COMMAND FILES WHICH SPECIFY PARTITION GEN OR 
PAR14K. GEN IS ASSUMED TO BE 40000(8) BYTES LONG 
AND IS ASSUMED TO BE BASED AT 40000(8). 

PAR14K IS A PARTITION WHICH IS 70000(8) BYTES LONG 
AND IS ASSUMED TO BE BASED AT 40000(8). 


me Ne Ne Ne Se TO te MO 


For a mapped system, no physical base addresses are required 
for partitions, and the corresponding two lines above are 
suppressed. 


SYSGEN PHASE III 


TASK FTB IS A FAST TASK BUILDER WITH LIMITED FUNCTIONALITY. 
IT DOES NOT SUPPORT OVERLAYS OR GLOBAL CROSS-REFERENCE 

BUT IT IS THREE TIMES FASTER THAN BIGTKB. IT REQUIRES 

A 20K PARTITION TO RUN IN AND IS NOT DISTRIBUTED IN TASK 
IMAGE FORM. YOU MUST BUILD IT IF YOU INTEND TO USE IT. 


THE TASK DSC IS THE DISK SAVE AND COMPRESS UTILITY. IT IS 
DISTRIBUTED AS A STANDALONE SYSTEM ON ALL DISTRIBUTION SYSTEMS 
AS DSCSYS.SYS. IT MAY ALSO BE BUILT AS A TASK, BUT IS NOT 
DISTRIBUTED IN THAT FORM. IT REQUIRES A 14K PARTITION TO RUN IN. 


ALL OF THE TASK BUILD COMMAND FILES BUILD CHECKPOINTABLE 

TASKS FOR USE WITH SYSTEMS WITH DYNAMIC ALLOCATION OF 

CHECKPOINT SPACE. IF YOUR SYSTEM DOES NOT SUPPORT 

THIS OPTION, INSTALL WILL DEFAULT THEM TO NON-CHECKPOINTABLE. 

IF YOU WISH YOU MAY BUILD TASKS WHICH ARE CHECKPOINTABLE 

AND WHICH ALLOCATE SPACE IN THEIR TASK IMAGE BY CHANGING 

THE /CP SWITCH TO THE /AL SWITCH IN THE BUILD COMMAND FILE. 
NOTE: TASKS WHICH ALLOCATE CHECKPOINT SPACE IN THEIR 
TASK IMAGE REQUIRE MORE DISK SPACE THAN TASKS THAT DON'T. 

SET /UIC=[1,2x] 

INS SEDI 


me Me Ms Me Me Ne Se Me Me TO Ne Ne TO Ne Te TO Te Te NO TO TO 


SYSGEN then asks the following question: 
Do you want to E edit and build, B - build task tskname 


where tskname is replaced by the name of the utility (for example, 
MAC). Enter E if you must edit the build command file, B to simply 
build the task, and carriage return to not build the task. SYSGEN 
repeats the above question for the following utility tasks (each task 
listed replaces tskname): 


MAC 
BIGMAC 
TKB 
BIGTKB 
PIP 
FLX 
VFY 
DMP 
EDI 
SLP 
LBR 
PSE 
SYE 
CRF 
ZAP 
BAD 
VMR 
FTB 
CMP 
PAT 
DSC 
CDA 
EDT 
FMT 
IOx 


If you enter E, SYSGEN invokes EDI and specifies the corresponding 
build command file (tsknameBLD.CMD) to be edited. When you exit EDI, 
SYSGEN builds the task. 


SYSGEN PHASE III 


SYSGEN then installs PIP and BIGTKB. 


DO YOU WANT TO PRINT THE MAPS FOR THE UTILITY TASKS 


The maps for the utility tasks are of little use; normally, 
respond No. 


If 
be 


you want. the maps and specified a line printer, the maps will 
printed on the line printer. If you want the maps but did not 


specify a line printer, they print on your terminal. 


The next display depends on the distribution kit you are using. The 
RLO1 and the dual RKOS5 kits require some preparation prior to building 
the utility tasks. Read the pertinent section. 


No preparations are necessary for big disk kits. 


AFTER 
A NEW 
PAUSE 


me Me Me Me Te Se Me Ne Ne Ne Me Me Ne Me Me MO Ne Ne Ne Se Se Ne te 


+ 


ENTER 


**RLO1 KITS** 


DEPENDING ON THE SECONDARY STORAGE MEDIUM AND THE NUMBER 

OF TASKS TO BE COPIED, YOU MAY HAVE TO MOUNT A BLANK MEDIUM 

IN THE DRIVE AFTER COPYING A TASK. THE RECOMMENDED NUMBER OF FILES 
PER MEDIUM IS: 


RKO5,RLO1 AND MAGTAPE (TSO03,RU10,TU16,TU45) - ALL TASKS WILL FIT 
FLOPPY DISK AND DECTAPE - 4 TASKS PER DISK OR TAPE 
CASSETTE - 1 TASK PER CASSETTE 


IF YOUR SECONDARY STORAGE IS OTHER THAN RKO5, RLO1 OR MAGTAPE, 


COPYING A TASK, YOU WILL BE ASKED IF YOU WISH TO MOUNT 
MEDIUM. IF SO THE INDIRECT FILE PROCESSOR WILL 
TO ALLOW TIME TO MOUNT IT. 


THE FOLLOWING ARE LEGAL SECONDARY STORAGE DEVICES: 


DK (RKOS DISK, FOR RKOS DISTRIBUTION KITS ONLY) 
DL (RLO1 DISK, FOR RLO1 DISTRIBUTION KITS ONLY) 
DX (RXO1 FLOPPY DISK) 

CT (TU60 CASSETTE TAPE) 

DT (TU56 DECTAPE) 

MT (TSO3, TE10, OR TULO MAGTAPE) 

MM (TU16, TE16, OR TU45 MAGTAPE) 

DY (RX211 FLOPPY DISK) 


DEVICE FOR SECONDARY STORAGE [DDU] [S]: 


The next query displayed is dependent on your’ secondary 
storage device. : 


*DK: or DL: as Secondary Storage Device* 


The following assumes DK; was entered as the secondary 
storage device. 


# PUT YOUR TARGET SYSTEM DISK IN DK: 


* IS DK: 


READY? [Y/N]: 


This query is repeated until the device is ready (Y 
response). 
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* ENTER VOLUME LABEL OF DK: {S]: 
The device is then mounted using this volume label. 
MOU DK: label 
*DX: aS Secondary Storage Device* 


If DX: is not loaded, the MCR LOA command is issued. 


LOA DX: 
*CT:,DT:,MT:, or MM:, as Secondary Storage* 
The following assumes DT: was entered as the secondary 
Storage device. 
If the secondary storage device is not loaded, the MCR LOA 
command is issued. 
LOAD DT: 


**DUAL RKOS Kits** 


* DO YOU HAVE AN EMPTY RKOS REMOVABLE DRIVE AVAILABLE? [Y/N]: 


If not, instructions are given for copying the task image 


files from secondary storage to the system disk. 


If an empty drive is available, you are asked to identify 


the unit number. 
* WHAT IS THE UNIT NUMBER OF THE EMPTY DRIVE? [O R:0-3] 3: 
The following assumes that DK2: is the empty drive. 


PLACE THE SYSTEM DISK IN DK2: AND START IT UP (WRITE 
ENABLED). WE WILL COPY THE TASKS DIRECTLY TO THE SYSTEM DISK. 


me Ne 


* IS THE SYSTEM DISK READY? [Y/N]: 


This question is repeated until the disk is ready 
response). When ready, the disk is mounted. 


MOU DK2:SYSTEM 
* WAS THE SYSTEM DISK MOUNTED SUCCESSFULLY? [Y/N]: 


If not, the MOU command is issued again. 


oe Me Ne 


NOW WE BUILD THE REQUESTED UTILITY TASKS 


c 

ASN LP:=MP: 
ASN TT:=MP: 
ASN NL:=MP: 
SET /UIC=[1,20] 


The selected utility tasks are now built. 


(Y 


TKB 
PIP 
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If using the RLO1 or the dual RKOS5S kit, the build files are 
copied to your secondary storage device and the old versions 
are deleted. Depending on your secondary storage device, 
either PIP or FLX is used to accomplish this (PIP for DL:, 
DK:, or DX: aS secondary storage and FLX for CT:, DT:, MM:, 
MT: as secondary storage). The appropriate command is 
issued following the task builder directive. The following 
is an example of the display for a dual RKO5 SYSGEN using an 
RKO5 (DK:) for secondary storage. 


@[{1,2x] MACBLD 
DK: [1,5x]/NV=[1,5x]MAC.TSK 


* WAS MAC COPIED SUCCESSFULLY? [Y/N]: 


PIP 


TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 
TKB 


{1,5x]MAC.TSK;0/DE 


For brevity, the PIP and/or FLX commands, which appear only 
if you are using an RLO1 kit or the dual RKOS kit, are 
omitted here. 


Note that all commands are suppressed for a specific task if 
that task was not selected to be rebuilt. The following 
displays all of the tasks. 


Similar commands are issued to build each of the selected 
utility tasks. In some cases, the old versions are purged 
(PIP.../PU), leaving the most recent version, instead of 
being deleted (PIP.../DE). The reason for this is to keep 
tasks that may be required at later stages during SYSGEN. 


@[1,2x]MACBLD 
@[1,2x] BIGMACBLD 
@[1,2x] TKBBLD 
@[{1,2x]BIGTKBBLD 
@[{1,2x] PIPBLD 
@{1,2x]FLXBLD 
@[1,2x]VFYBLD 
@{1,2x]DMPBLD 
@(1,2x]EDIBLD 
@[1,2x]SLPBLD 
@{1,2x]LBRBLD 
@({1,2x] PSEBLD 
@[1,2s]SYEBLD 
@[{1,2x]CRFBLD 
@{1,2x] ZAPBLD 
@[{1,2x]BADBLD 
@[1,2x] VMRBLD 
@[1,2x]PATBLD 
@{1,2x]CDABLD 
@{1,2x]CMPBLD 
@(1,2x]FTBBLD 
@{1,2x]DSCBLD 
@[1,2x]SRDBLD 
@[1,2x] EDTBLD 
@[1,2x] RMSBCKBLD 
@[1,2x] RMSCNVBLD 
@{1,2x]RMSDEFBLD 
@[1,2x] RMSDFNBLD 
@[1,2x] RMSDSPBLD 
@(1,2x]RMSRTIBLD 
@[{1,2x] VTECBLD 


The task-builds are complete. 


» 


me Me Me Me Me te NO 


i 


> 
4 


DMO DXO: 
UNL DX0: 


we Ne Ne te te 


me Me Ne Me Me Me we Ne we Me Ne Ne Ne MO 
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If user mode diagnostics were to be built, control passes to 
the indirect command file BLDUMD.CMD (see Section 9.2). The 
task image files that have been built (utilities and/or user 
mode diagnostics) will now be transferred to secondary 
storage. 


WE WILL PAUSE NOW TO ALLOW YOU TO COPY 
- ANY FILES THAT WERE NOT SUCCESSFULLY TRANSFERRED 
- THE DIAGNOSTIC TASKS 

WHEN THE DIAGNOSTIC TASKS HAVE BEEN COPIED, YOU 

MAY DELETE THEM FROM THIS DISK. 

WHEN DONE, RESUME AT. AS SHOWN BELOW. 


If only user mode diagnostics were selected to be built and 
no utility task, an example of how to do the transfers is 
displayed like the one below. 


(PUT A BLANK MEDIUM IN MTO:) 

>REM PIP 

>INS [1,54] FLX;-1 

>FLX MTO:/ZE 

>FLX MTO:/DO=RK0O5.TSK/RS,TSO3.TSK,TERM.TSK 
>RES ...AT. 


-- PAUSING. TO CONTINUE TYPE “RES ...AT." 


At this time, you may manually copy any files that were not 
successfully transferred by the previous commands, and/or 
the user mode diagnostics if they were selected to be built. 


The secondary storage is dismounted and the driver unloaded. 


If you have a dual-RKO5 system, the task image files are now 
resident on the target system disk. Otherwise, the 
following section of text is displayed to guide you in 
transferring the task image files to the target system disk. 


TO COPY THE TASK IMAGE FILES FROM THE SECONDARY 
STORAGE MEDIUM TO THE SYSTEM DISK, PROCEED AS FOLLOWS 
AFTER SYSGEN3 HAS TERMINATED: 


I£f your secondary storage is DX, the following example is 
displayed (u is replaced by the actual unit number): 


(BOOT THE SYSTEM DISK) 
>SET /UIC=[1,5x] 


>INS PIP 
>LOA DX: 
! REPEAT FROM HERE... 
>MOU DXu: TASKX ! REPLACE "TASKX" BY 
! ACTUAL VOLUME LABEL 
>PIP =DXu:*.* 
>DMO DXu: ! ...TO HERE FOR ALL VOLUMES 
! USED FOR TRANSFER 
>UNL DX: 
>REM PIP 


me te Mee Me Ne Me TO Te Ne Se TO. Ne TO Ne we NO Ne 


REM FLX 
REM INI 
REM UFD 
REM PIP 
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If your secondary storage is MT, MM, CT or DT, the following 
example is displayed (dd is replaced by the actual device 
mnemonic, and u is replaced by the actual unit number): 


(BOOT THE SYSTEM DISK) 
>SET /UIC=[1,5x] 

>INS FLX 

>LOA dd: 


{ REPEAT FROM HERE... 


>FLX =ddu:*.* 


-_ 


«+-TO HERE FOR ALL VOLUMES 
{ USED FOR TRANSFER 


>UNL dd: 

>REM FLX 

>INS PIP;-1 

>@MTSKCO ! MAKE TASK FILES CONTIGUOUS 


! A SERIES OF PIP COMMANDS FOLLOW 


>@ <EOF> 
>PIP MTSKCO.CMD; 0/DE 
>REM PIP 


***USER MODE DIAGNOSTICS*** 


Due to space limitations and the physical locations of files 
on the RKO5 distribution kits, the user mode diagnostics are 
built in slightly differing ways. Read the section 
pertinent to your distribution kit. 


SET /UIC=[1,20] 


me SO Ne Me Te Ne Se Me Me Me Te Ne Me Te Me Ne Me NO Ne Ne te NO Me 


**RLO1 Kits** 


NOW WE BUILD AND COPY THE TASK TO THE SECONDARY 

STORAGE MEDIUM. 

DEPENDING ON THE SECONDARY STORAGE MEDIUM AND THE NUMBER 

OF TASKS TO BE COPIED, YOU MAY HAVE TO MOUNT A BLANK MEDIUM 

IN THE DRIVE AFTER COPYING A TASK. THE RECOMMENDED NUMBER OF FILES 
PER MEDIUM IS: 


RKO5,RLO1 AND MAGTAPE (TSO03,TU10,TU16,TU45) - ALL TASKS WILL FIT 
FLOPPY DISK AND DECTAPE - 4 TASKS PER DISK OR TAPE 
CASSETTE - 1 TASK PER CASSETTE 


DK 
DL 
DX 
cT 
DT 
MT 
MM 


IF YOUR SECONDARY STORAGE IS OTHER THAN RKO5, RLO1 OR MAGTAPE, 
AFTER COPYING A TASK, YOU WILL BE ASKED IF YOU WISH TO MOUNT 
A NEW MEDIUM. IF SO THE INDIRECT FILE PROCESSOR WILL 

PAUSE TO ALLOW TIME TO MOUNT IT. 


THE FOLLOWING ARE LEGAL SECONDARY STORAGE DEVICES: 


(RKO5 DISK, FOR RKO5 DISTRIBUTION KITS ONLY) 
(RLO1 DISK, FOR RLO1 DISTRIBUTION KITS ONLY) 
.(RXO1 FLOPPY DISK) 

(TU60 CASSETTE TAPE) 

(TUS6 DECTAPE) 

(TSO03, TE10, OR TU1O MAGTAPE) 

(TU16, TE16, OR TU45 MAGTAPE) 
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* ENTER DEVICE FOR SECONDARY STORAGE [DDU] [S]: 


The next query displayed is dependent on your’ secondary 
storage device. 


*DK: or DL: as Secondary Storage Device* 


The following assumes DK: was entered as the secondary 
storage device. 


PUT YOUR TARGET SYSTEM DISK IN DK: 


=e 


* IS DK: READY? [Y/N]: 


This query is repeated until the device is ready (Y 
response). 


* ENTER VOLUME LABEL OF DK: [S]: 
The device is then mounted using this volume label. 
MOU DK:volume label 


Control then passes to the indirect command file BLDUMD.CMD 
(see that Section). 


*DX: as Secondary Storage Device* 
Tf DX: is not loaded, the MCR LOA command is issued. 
LOA DX: 
TO COPY THE TASK IMAGE FILES FROM THE SECONDARY 


STORAGE MEDIUM TO THE SYSTEM DISK, PROCEED AS FOLLOWS 
AFTER SYSGEN3 HAS TERMINATED: 


(BOOT THE SYSTEM DISK) 
>SET /UIC = [1,5x] 


>INS S$PIP 
>LOA DX: 
{REPEAT FROM HERE... 
>MOU DX: TASKX ! REPLACE "TASKX" BY 
| ACTUAL VOLUME LABEL 


>PIP = DX:*.* 

>DMO DX: 
!...TO HERE FOR ALL VOLUMES 
!USED FOR TRANSFER 

>UNL DX: 


me Ne Ne Ne Me Ne Se we Se Ne we Ne Me Me Se Ne Se te 


Control then passes to the indirect command file BLDUMD.CMD 
(see Section 9.2). 


*CT:, DT:, MT:, or MM: as Secondary Storage Device* 


The following assumes DT: was entered as the secondary 
storage device. 


If the secondary storage device is not loaded, the MCR LOA 
command is issued. 
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LOA DT: 


TO COPY THE TASK IMAGE FILES FROM THE SECONDARY 
STORAGE MEDIUM TO THE SYSTEM DISK, PROCEED AS FOLLOWS 
AFTER SYSGEN3 HAS TERMINATED: 


(BOOT THE SYSTEM DISK) 

>SET /UIC = [1,5x] 

>INS SFLX 

>LOA DT: 
| REPEAT FROM HERE... 

>FLX = DT:*,* 
1... TO HERE FOR ALL VOLUMES 
1! USED FOR TRANSFER 


me te Ne Te Me Me Me Me Me Me Ne Ne Me 


>UNL DT: 


>REM FLX 


~~ 


Control then passes to the indirect command file BLDUMD.CMD 
(see Section xxx). 


**Dual RKOS5S Kits** 
* DO YOU HAVE AN EMPTY RKO5 REMOVABLE DRIVE AVAILABLE? [Y/N]: 


If not, instructions are given for copying the task image 
files from secondary storage to the system disk. 


If an empty drive is available, you are asked to identify 
the unit number. 


* WHAT IS THE UNIT NUMBER OF THE EMPTY DRIVE? [O R:0-3]: 
The following assumes that DK2: is the empty drive. 


PLACE THE SYSTEM DISK IN DK2: AND START IT UP (WRITE 
ENABLED). WE WILL COPY THE TASKS DIRECTLY TO THE SYSTEM DISK. 


me we 


* IS THE SYSTEM DISK READY? [Y/N]: 


‘This question is repeated until the disk is ready (Y 
response). When ready, the disk is mounted, 


MOU DK2:SYSTEM 
* WAS THE SYSTEM DISK MOUNTED SUCCESSFULLY? [Y/N]: 
If not, the MOUnt command is issued again. 


If mounted successfully, control passes to the indirect 
command file BLDUMD.CMD (see Section 9.2). 


**Al1 Kits Except RLO1 Kit and RKO5 Kits** 


Control is passed directly to the indirect command file 
BLDUMD.CMD (see Section 9.2). 


End of SYSGEN Phase III. 
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9.2 BLDUMD.CMD FILE DETAILS 
BLDUMD is the indirect command file to task-build all or selected User 
Mode Diagnostics. BLDUMD is called from SYSGEN Phase III if the 
corresponding question is answered appropriately. It may also be 
called manually at any time with the following command: 

>@[200,200] BLDUMD 


The following is a detailed description of all the steps in BLDUMD. 


BLDUMD <VERSION 03.1> 


COPYRIGHT (C) 1976, 1977, 1979 
DIGITAL EQUIPMENT CORP., MAYNARD, MASS. 01754 


BUILD ALL OR SELECTED USER MODE DIAGNOSTICS. 


ARE YOU RUNNING ON A MACHINE WITH AT LEAST 24K WORDS? [Y/N]: 


mo Ste Ne te Se ms Me MO Ne NO 


If the answer is N, the following text is displayed and 
BLDUMD terminates. 


SORRY, YOU CANNOT BUILD (OR RUN) THE USER MODE DIAGNOSTICS 
ON A MACHINE WITH LESS THAN 24 K WORDS! 


=o te ™O 


=e 


Otherwise, processing continues here. 


As in the previous sections of SYSGEN, you must identify 
your distribution kit. 


* DO YOU HAVE THE DUAL RKO5 DISTRIBUTION KIT? [Y/N]: 
If you do, you are asked to identify the RKO5 drives that 
contain the UTLOBJ and RSXM26 disks. The UTLOBJ disk is 
then assigned to SY: and the RSXM26 disk is assigned to 
LBs. 

* IN WHICH RKO5 DRIVE IS THE UTLOBJ DISK MOUNTED? [0 R:0-3]: 

* IN WHICH RKOS DRIVE IS THE BASSLINE DISK MOUNTED? [0 R:0-3]: 


The following assumes DKO: for the UTLOBJ disk and DKI: 
for the RSXM26 disk. 


ASN DKO:=SY: 
ASN DK1:=LB: 


If you replied negatively to the dual RKOS query, the next 
query displayed is 


* IS THE CURRENT SYSTEM DISK AN RP02/03/04/05/05 OR RK06/07? 
* DO YOU WANT EXPANDED COMMENTS FOR THE UMD BUILD PROCEDURE? [Y/N]: 


Expanded comments provide a lot of descriptive text that the 
experienced user might want to dispense with. 


Wwe MH Me we Me we me Me Te Ne MO MO Ne TO TO Ne Ne Me we NO Me MO ME MO Ne Ne Ne MO 


me Se Me Se Me Me te Me Ne 


* 
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DIAGNOSTIC TASKS CAN BE BUILT FOR THE FOLLOWING DEVICES: 


MNEMONIC DEVICE DIAGNOSTIC NAME 
DB: RJP04/RWP04 RP04 
DB: RJPOS/RWPOS RPO5 
DB: RJPO6/RWP06 RP06 
DF: RF11/RS11 RF11 
DK: RK11/RKO5 RKO5 
DM: RK611/RK06 RKO6 
DM RK611/RK07 RKO7 
DP: RP11/RP02 RP02 
DP: RP11/RP03 RPO3 
DP: RP11E/RPRO2 RPRO2 
DS: RJS03/RWS03 RSO3 
DS: RJS04/RWS04 RS04 
DT: TC11/TU56 TU56 
MM: TJU16/TWU16 TU16 
MM: TJIU1L6/TWU45 TU45 
MT: TMA11/TU1O TU1O 
MT: TMA11/TS0O3 TS03 
TT: TERMINAL TERM 
DRIVE 


COMPATIBILITY COMP 
DO YOU WANT DIAGNOSTICS FOR A MAPPED SYSTEM? [Y/N]: 
IS THE TARGET SYSTEM AN 11/70 [Y/N]: 


ET UIC=(1,2x] 


If you are using other than a dual RKO5 distribution kit, 
the task image files will be generated on the system disk, 
and the next section is bypassed. 


THE DIAGNOSTIC TASKS WILL BE STORED ON THE SYSTEM DISK BY DEFAULT. 
IF YOUR SYSTEM DISK IS AN RKO5 YOU MAY BE REQUIRED TO STORE THE 
DIAGNOSTICS ON A SEPARATE DISK TO AVOID ALLOCATION PROBLEMS. 


IF YOU HAVE THE DUAL RKOS RELEASE KIT, YOU SHOULD SPECIFY 

THAT THE DIAGNOSTICS BE STORED ON ANOTHER DISK. IF YOU HAVE 

A THIRD RKOS PUT THE PRIVOBJ DISK IN IT AND STORE THE DIAGNOSTICS 
ON IT. OTHERWISE, STORE THEM ON LBO:. 


DO YOU WANT THE DIAGNOSTICS STORED ON ANOTHER DISK? [Y/N:] 
If this question is answered with an N, the next section is 
bypassed, Otherwise, you are asked for the device mnemonic 
and unit number of the disk where to store the diagnostics. 


ENTER THE OUTPUT DEVICE NAME AND UNIT NUMBER (E.G. DK1l) [S]: 


It is assumed in the following lines that you answered this 
question with DKl. 


me Ts Se Te Me Re Ne Te Me NO Ne te 


me we Me Me Ne Me ND 


Heme we 


+ 
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THE COMMAND BUILD FILE WILL NOW PAUSE WHILE YOU MOUNT DK1: 
YOU MUST CREATE THE UFD'S [1,3x] AND [1,5x] ON THE DISK 
(THE FORMER ONLY IF YOU WANT THE TASK BUILD MAPS) IF THEY 
DO NOT ALREADY EXIST. 


EXAMPLE: 
>INIT DK1:DIAGNOSTICS 
>MOUNT DK1:DIAGNOSTICS 
>UFD DK1:[1,3x] 
>UFD DK1:[1,5x] 


AT. -- PAUSING. TO RESUME TYPE “RES ...AT." 


Whatever the system disk type is, processing continues here. 


DIAGNOSTICS ARE GENERALLY RUN WITH THE FOLLOWING ATTRIBUTES: 


PARTITION = GEN 
BASE ADDRESS = 40000 
SIZE = 40000 


The last two lines appear only if you are building 
diagnostics for an unmapped system. 


IF YOUR SYSTEM IS DIFFERENT ANSWER YES TO THE FOLLOWING QUESTION. 
DO YOU WANT TO ALTER THE DEFAULT PARTITION ATTRIBUTES? [Y/N]: 


The following three questions are bypassed if you answered 
this question with an N. 


ENTER THE PARTITION NAME (DEFAULT=GEN) [S]: 


The following question is asked only if you are building 
diagnostics for an unmapped system. 


ENTER THE PARTITION BASE ADDRESS (DEFAULT=40000) [8S]: 
ENTER THE PARTITION SIZE (DEFAULT=40000) [S]: 


THE DIAGNOSTIC TASKS ARE NORMALLY BUILT TO TRANSFER DATA VIA 
A 2000 OCTAL BYTE DATA BUFFER. YOU MAY SPECIFY A DIFFERENT 
BUFFER SIZE BY ANSWERING THE NEXT QUESTION. 


ENTER THE BUFFER SIZE IN OCTAL BYTES (DEFAULT=2000) [S]: 


NORMALLY DIAGNOSTIC TASK BUILD MAPS ARE NOT REQUIRED. 
IN THE UNLIKELY EVENT YOU NEED THEM, ANSWER "YES" TO THE 
FOLLOWING QUESTION. 


DO YOU WANT TASK BUILD MAPS? [Y/N]: 
DO YOU WANT THE MAPS LISTED ON THE LINEPRINTER? [Y/N]: 


If you answered Y to the first question and N to the second 
of the two questions above, the maps will be directed to UFD 
(1,3x] on the output disk, 
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NORMALLY YOU ENTER EACH DIAGNOSTIC NAME REQUIRED FOR YOUR SYSTEM. 
AN ALTERNATE METHOD IS PROVIDED WHICH ALLOWS BUILDING ALL 
AVAILABLE DIAGNOSTICS. THIS METHOD REQUIRES ABOUT 500 BLOCKS OF 
DISK SPACE ON THE OUTPUT DEVICE. THE DIAGNOSTICS THAT DO NOT APPLY 
CAN BE DELETED AT A LATER TIME. 


% he Te Ne Ne Ne Se Ne 


DO YOU WANT TO BUILD ALL AVAILABLE DIAGNOSTICS? [Y/N]: 
HAVE ALL QUESTIONS BEEN ANSWERED TO YOUR SATISFACTION? [Y/N]: 


If you answered these questions with N, processing will 
restart at the beginning of BLDUMD. Otherwise, if you want 
to build all diagnostics, the next section that asks for 
diagnostic names is bypassed. 


ENTER THE NAME OF THE DIAGNOSTIC TASKS TO BUILD, ONE AT 
A TIME. WHEN DONE, ENTER A SINGLE CARRIAGE RETURN. 


THE FOLLOWING IS A LIST OF VALID DIAGNOSTIC NAMES: 
RP04,RP05,RP06,RF11,RK05,RK06,RP02,RP03,RPRO2,RS03 
RS04,TU56,TU16,TU45,TU10,TSO3,TERM 


HERE IS A SAMPLE DIALOGUE TO BUILD THE RJPO4/RWPO04 DISK AND THE 
TMA11/TSO3 MAGTAPE DIAGNOSTICS ( <CR> = CARRIAGE RETURN) : 


NAME [S]:RP04<CR> 
NAME [S]:TS03<CR> 
NAME [S]:<CR> 


me Ne Me TO Te Te Ne NO ue Ne Se Se Se Ne Me 


The next question requires as a response, the name of the 
next diagnostic to build, out of the list shown above. 


* NAME [S]: 
If an invalid name is entered (for example "XX"), the 


following message is displayed, and the question is 
repeated. 


= 


kekkKE "XX" DIAGNOSTIC IS NOT AVAILABLE***** 


The question "* NAME [S]:" is repeated to allow you to enter 
the names of all diagnostics to be built. When done, answer 
with a single carriage return. 


If you chose to build all the diagnostics, or when you have 
entered the names of all the desired diagnostics, processing 
continues here. 


; 
; NOW WE TASK BUILD THE SELECTED DIAGNOSTICS 


; 
INS SBIGTKB 
TKB @UMDBLD 


The command above builds the selected diagnostics, according 
to specifications defined by the previous sections. 


REM TKB 


End of UMDBLD. 


>e@[ 
>7 


>* 
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The following sample dialogue builds diagnostics for 

TU16, and terminals to run on an unmapped system. T 
partition in that system starts at 50000. The task 

files are directed to the target system disk which is 

drive DKl:. 


200,200] BLDUMD 
BLDUMD <VERSION 03.1> 


COPYRIGHT (C) 1976, 1977, 1979 
DIGITAL EQUIPMENT CORP., MAYNARD, MASS. 01754 


BUILD ALL OR SELECTED USER MODE DIAGNOSTICS. 


ARE YOU RUNNING ON A MACHINE WITH AT LEAST 24K WORDS? [Y/N] :¥ 
DO YOU HAVE THE DUAL RKO5 DISTRIBUTION KIT? [Y/N]: 
IS THE CURRENT SYSTEM DISK AN RP02/03/04/05/06 OR RKOG6? [Y/N] 
DO YOU WANT EXPANDED COMMENTS FOR THE UMD BUILD PROCEDURE? [Y 
DO YOU WANT DIAGNOSTICS FOR A MAPPED SYSTEM? [Y/N]: 


>SET /UIC=[1,20] 


DO YOU WANT THE DIAGNOSTICS STORED ON ANOTHER DISK? [Y/N] :Y¥ 
ENTER THE OUTPUT DEVICE NAME AND UNIT NUMBER (E.G. DK1) [S]: 


THE COMMAND BUILD FILE WILL NOW PAUSE WHILE YOU MOUNT DK1: 
YOU MUST CREATE THE UFD'S [1,30] AND [1,50] ON THE DISK 
(THE FORMER ONLY IF YOU WANT THE TASK BUILD MAPS) IF THEY 
DO NOT ALREADY EXIST. 


-- PAUSING. TO CONTINUE TYPE "RES ...AT" 


>MOU DK1:UNMOBJ 
>RES ...-AT 


AT. 


-- CONTINUING 


DO YOU WANT TO ALTER THE DEFAULT PARTITION ATTRIBUTES? [Y/N]: 
ENTER THE PARTITION NAME (DEFAULT=GEN) [S]: 

ENTER THE PARTITION BASE ADDRESS (DEFAULT=40000) [S]: 50000 
ENTER THE PARTITION SIZE (DEFAULT=40000) [S]: 

ENTER THE BUFFER SIZE IN OCTAL BYTES (DEFAULT=2000) [S]: 

DO YOU WANT TASK BUILD MAPS? [Y/N]: 

DO YOU WANT TO BUILD ALL AVAILABLE DIAGNOSTICS? [Y/N]: 

HAVE ALL QUESTIONS BEEN ANSWERED TO YOUR SATISFACTION? [Y/N]: 


ENTER THE NAME OF THE DIAGNOSTIC TASKS TO BUILD, ONE AT 
A TIME. WHEN DONE, ENTER A SINGLE CARRIAGE RETURN. 


NAME [S] 
NAME [S] 
NAME [S] 
NAME 


RKO5 
TU16G 
TERM 


Comal 
n 


NOW WE TASK BUILD THE SELECTED DIAGNOSTICS 


>TKB @UMDBLD 


oF 
>@ 
> 


<EOF> 


RKO5, 
he GEN 
image 
put in 


2¥ 
/N): 


DK1 


Y 
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CHAPTER 10 


INSTALLATION VERIFICATION PROCEDURE 


10.1 INTRODUCTION 


The RSX-1LIM Installation Verification Procedure checks out the 
software-hardware system that you created during the SYSGEN process. 
The procedure does not replace the hardware diagnostics that DIGITAL 
Field Service runs on individual devices nor does it substitute for 
software testing during software development. The procedure merely 
verifies that your generated system has produced a working system with 
the configuration that you requested during SYSGEN. 


The Installation Verification Procedure consists of a set of 
controlling command files that run a series of test modules that gives 
the system a rigorous exercising. The procedure exercises two areas 
of the system: hardware, discussed in Section 10.2 and software, 
discussed in Section 10.3. 


10.2 HARDWARE 


As a result of running this procedure, you know what devices were 
successfully generated into the system and you have verified the 
functioning of all disk and tape units under operating system control. 
The procedure operates the devices under varying system loads. 


10.2.1 System I/O Exerciser 


The system I/O exerciser verifies the functioning of all disk and tape 
units on the system and identifies all devices to be tested. The 
exerciser tests disks as Files-1ll volumes (mounted automatically) that 
are public or not allocated by another user. Also, the exerciser 
tests DECtape, cassettes, and magtape by using AST driven QI0 
requests. 


After the test, the exerciser deletes all files that it has created on 
these volumes. However, the exerciser does not modify the disk 
structure or any existing disk data. Be aware that the exerciser 
overwrites tapes and destroys their contents. 


10.3 SOFTWARE 


The software verification modules of the procedure quickly access and 
exercise those discrete system software components that can he 
operated under command file control. This operation tests the 
completeness of the System Generation procedure. 
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10.3.1 CPU=-bound Load Test 


The €PU-bound load test determines whether the system can handle a 
heavy loading of parallel processing, compute-bound tasks. This test 
determines whether the entire memory encompassed by the system 
Partition, GEN, is available to the system. This test uses the 
checkpointing, swapping, and round-robin scheduling Executive options 
when present. Also, this test uses the Send and Receive Executive 
directives. This test cannot be run in an unmapped system and 
therefore is skipped in an unmapped system. 


10.3.2 System Utilities Verification 

This test invokes most of the standard RSX-11M system utilities and 
verifies their presence and operation by using an indirect command 
file routine. The test invokes interactive editors and the ACNT 
program to demonstrate that an executable task file exists. You can 


choose to execute some functions in these programs or exit from them 
immediately. 


10.4 OPERATING PROCEDURES 
Your system must meet certain configuration and operational 


requirements to run the entire Installation Verification Procedure. 
These requirements follow. 


10.4.1 Configuration Restrictions 
e The hardware verification section requires that the system 
support ASTs, The I/O exerciser and CPU-bound load test use 
ASTs. 


e If the system is unmapped, the procedure does not execute the 
CPU-bound load test. 


If your system does not support any of the following features, the 
CPU-bound load test cannot run. However, the procedure determines 
whether your system supports the following features. It does not run 
the CPU-bound test if any are missing. 
The required features for the CPU-bound load test are: 

@e Send/Receive directives 

e Alter Priority directive 

@e Get Partition Parameters directive 


e AST support 


@ Dynamic checkpointing 
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INSTALLATION VERIFICATION PROCEDURE 


Operating Environment 


Run the Installation Verification Procedure following the 


completion of SYSGEN. The devices to be tested cannot be 
allocated to other users. 


You should run the Installation Verification Procedure on a 
stand-alone basis if possible. The procedure puts a heavy 
load on the system to the detriment of the throughput of other 
system users. The procedure should have an unlimited access 
to system features and devices to properly do its assigned 
task. 


You must run the procedure from a privileged terminal. 


The procedure runs from UIC [2,300]. If you wish, you can 
delete the entire contents of [2,300] after a successful run. 


You must place scratch tapes on all magnetic tape drives, 
including cassettes and DECtapes. Files-1l initialized disks 
must be placed on all disk drives. 


The procedure can be repeated without the necessity of 
rebuilding DEFINE.TSK if DEFINE is installed. 


The procedure needs only one terminal to run. If a second, 
CRT terminal exists, you can use it to run RMDEMO. If one 
terminal is a printing terminal, use it to run the procedure 
to allow you to check the printout for errors. I£ you must 
run the procedure from a CRT terminal, you must watch the 
terminal very closely to avoid missing important information 
(for example, error messages) that you may need later. 


Operating Instructions 


Boot the system. 
Allocate a large checkpoint space for the system. 
Place scratch media on all DECtape, cassette and magtape 
drives. Place initialized disk packs on all empty drives. 
The packs need not be scratch packs because data is not lost 
on them. 
Execute the command file, SAM. For example: 

>@[2,300] SAM 
From this point, the operating instructions are part of the 
console dialogue, which follows in Section 10.4.4, “Sample 


Console Dialogue". When the procedure runs to completion, 


examine the dialogue for error messages. These fall into 
three categories: 


a. A function did not execute because this system 
intentionally does not contain the function. 


b. A function did not execute because of a SYSGEN error. 


c. <A hardware problem occurred. 
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10.4.4 Sample Console Dialogue 


The following console dialogue is from an actual session of running 
the RSX-11M Installation Verification Procedure. It is included here 
to guide you and give you an indication of what to expect when you run 
your procedure, Before you begin, mount the Executive source disk 
(EXCSRC) and assign it to SY:. 


>SET /UIC=[2,300] 
>MOU DLO:/OVR 
>PIP =DLO:SAM.CMD 


>@SAM 

: KREEKKEKKEKEKEEEKKKEKEKREKEKKEKKKKEKKEKKKEKKKKEKKKKRREK 
. * * 
’ 

; * RSX-11M INSTALLATION VERIFICATION PROCEDURE * 
° * * 
; KREKKKKEKEEKEREKRKEKEKKEEKEKKEEKEEERRKEKEEKKRKEKKEREKKKKKEK 
>; 


>SET /UIC=[2,300] 
>INS LB:SPIP 
>RUN ERRLOG 


ERL -- ERROR LOG INITIALIZED 

>; 

>* DO YOU WISH TO RUN RMDEMO? [Y/N]: N 
ERL -- ERROR LOG INITIALIZED 

>; 


>* ENTER UNIT NUMBER OF TERMINAL [S]: 0 


: #kEK NOTE ¥*8* 


>; TEST MEDIA MUST BE LOADED ON ALL TAPE AND DISK DRIVES. USE SCRATCH 
>; TAPES AND FILES-11 FORMAT DISKS. 


; ALL MAGTAPES BEING TESTED ARE OVER-WRITTEN. THE DISKS ARE 
+ TESTED WITH FILE-STRUCTURED I/O WITH NO NEGATIVE EFFECT ON DATA 
>; OR STRUCTURE. 


>; BEFORE PERFORMING THE FILE-STRUCTURED I/O TEST, ALL UNMOUNTED 
7 DISKS ARE MOUNTED AUTOMATICALLY. 
>* DO YOU NEED TO INITIALIZE ANY DISKS? [Y/N]: N 


>TIM 
12:57:52 06-FEB-79 


>; NEEDED UTILITIES WILL BE INSTALLED NOW. 
Dp RRRRKKARKK 


Dp RRR RRR RRR IRR RRR IRI RRR RRR RIKI RRR RK AIK ARERR IIE IK 
>PIP TAILLOR.DAT=DEVM.SAM/AP 

>MAC DEFINE=[11,10] RSXMC/PA:1, [2,300] DEFINE 

>TKB DEFINE/PR/CP=DEFINE,LB: [1,54] RSX11M.STB, [1,1] EXELIB/LB 
>INS DEFINE/TASK=DEFINE 

>PIP *.*/PU 

>RUN DEFINE 


i * CPU-BOUND LOAD TEST * 
>INS DUMMY/TASK=DUMO0/PRI=40. 


>INS LOGGER/TASK=L0G00 
>INS QTRUN /TASK=QTROO 
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>RUN DUMOO 


FOR THE NEXT FEW MINUTES A NUMBER OF COMPUTE BOUND TASKS WILL BE 
EXERCISING THE MEMORY, THE MULTI-TASKING CAPABILITIES OF THE 
SYSTEM AND, IF INCLUDED IN THIS SYSTEM, THE ROUND-ROBIN SCHEDULER, 
THE SHUFFLER, AND CHECKPOINTING. THE ACTION OF THESE LAST THREE 
FEATURES CAN BE SEEN ON THE RMDEMO SCREEN. IF THE SYSTEM IS 
PERFORMING PROPERLY, ALL OF THE "GEN" IS USED AND THE "QT" 

TASKS ARE SHARING THE SYSTEM RESOURCES IN A MANNER CONSISTENT 
WITH THE FEATURES AVAILABLE. NOTE THAT CHECKPOINTING IS DISABLED 
FOR THE SECOND HALF OF THE TEST. 


>} **k* THIS TEST RUNS FOR A MAXIMUM OF 6 MINUTES *** 
ai 

>RUN QTROO 

> 

>TIM 


12:59:51 O6-FEB-79 

>INS NUL3/TASK=QT0000 
>INS NUL3/TASK=QT0100 
>INS NUL3/TASK=QTO 200 
>INS NUL3/TASK=QTO 300 
>INS NUL3/TASK-QTO 400 
>INS NUL3/TASK=QTO0500 


>>>>>> THE LOAD TEST IS RUNNING <<<<<< 


>TIM 

13:06:15 06-FEB-79 
>REM QTOOOO 

>REM QTO100 

>REM QTO200 

>REM QT0300 

>REM QT0400 

>REM QTO500 


* TEST COMPLETED * 


* SYSTEM I/O EXERCISER * 


THE FOLLOWING DEVICES HAVE BEEN GENERATED INTO YOUR SYSTEM. THOSE 
LISTED AS “OFFLINE” ARE NOT PHYSICALLY PRESENT AND ARE NOT 

TESTED. INDIVIDUAL MAG TAPE, DEC TAPE AND RKOS UNITS 

CAN BE SHOWN ERRONEOUSLY AS ONLINE WHEN THE CONTROLLER IS ONLINE. 
THEY ARE TESTED AND THE TEST FAILS AFTER SEVERAL MINUTES 

OF ERROR MESSAGES. 


> DEV 

LPO: LOADED 

DBO: OFFLINE LOADED TYPE=RP04 
DB1: LOADED TYPE=RP04 

DB2: OFFLINE LOADED TYPE=RP04 
DB3: MOUNTED LOADED LABEL=RSX26 TYPE=RP04 
DB4: OFFLINE LOADED TYPE=RP04 
DDO: OFFLINE UNLOADED 

DD1: OFFLINE UNLOADED 

DKO: LOADED 

DKl: LOADED 

DLO: OFFLINE UNLOADED TYPE=RL0O1 
DL1: OFFLINE UNLOADED TYPE=RLO1 
DMO: OFFLINE LOADED TYPE=RK06 
DM1: LOADED TYPE=RK06 

DPO: UNLOADED TYPE=RP02 
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DPl: UNLOADED TYPE=RP02 

DRO: OFFLINE UNLOADED TYPE=RM03 

DRL: UNLOADED TYPE=RMO03 ae, 
DSO: OFFLINE UNLOADED TYPE=RS04 

DSL: OFFLINE UNLOADED TYPE=RS03 

DTO: OFFLINE LOADED 

DTl: OFFLINE LOADED 

DXO: OFFLINE LOADED 

DX1: OFFLINE LOADED . 
MMO: UNLOADED 

MM1: UNLOADED 

MTO: OFFLINE LOADED 

MTL: OFFLINE LOADED 

MSO: OFFLINE UNLOADED . 
TTO: [2,300] - LOGGED ON LOADED 

TTL: LOADED 

TT2: LOADED 

TT3: LOADED 

TT4: LOADED 

TTS: LOADED 

TT6: LOADED 

TT7: LOADED 

TT10: LOADED ~ 


TT1ll: LOADED 
TT12: LOADED 
TT13: LOADED 
TT14: LOADED 
TT15: LOADED 
TT16: LOADED 
TT17: LOADED 


TT20: LOADED 
TT21: LOADED 
TT22: LOADED . am 


TT23: LOADED 
TT24; LOADED 
TT25: LOADED 
TT26: LOADED 
TT27: LOADED 


TT30: LOADED 
TT31: LOADED 
TT3 2: LOADED 


TT33: LOADED 

| TT34: LOADED 
TT35: LOADED aa. 
TT36: LOADED 
TT37: LOADED 


NLO: 

TIO: 

coo: TTO: 
CLO: TTO: 
LBO: DB3: 
SYO: DB3: 
WKO: DBO: 


3 

7 

>; IF ANY DRIVERS ARE UNLOADED, THEY ARE LOADED NOW. 
>: 

sy REAKKKKKRKE 

>LOA DP: . 
>LOA MM: /PAR=GEN 

LOA -- INTERRUPT VECTOR ALREADY IN USE 

>; KEKE EKER ERAKEREKAREAKREKRAREKAEKRARKKE EK 
>INS [2,300] IOX/TASK=...SI10O 

>MOU DB1:/OVR/VI 
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MOUNT-** VOLUME INFORMATION** 


DEVICE = DBl: 

CLASS = FILE 1l 

LABEL = RSX11M 

UIC = [1,1] 

ACCESS = [RWED,RWED,RWED,RWED] 
CHARAC = 


0] 
>MOU DK1:/OVR/VI 
MOUNT-**VOLUME INFORMATION** 


DEVICE = DKl: 

CLASS = FILE 11 

LABEL = SYSTEM 

UIC = [1,1] 

ACCESS = [RWED,RWED,RWED,RWED] 
CHARAC = [] 


>MOU DKO:/OVR/VI 
MOUNT-**VOLUME INFORMATION** 


DEVICE = DKO: 

CLASS = FILE 1l 

LABEL = UTIL 

uIC = [2,300] 

ACCESS = [RWED,RWED,RWED,RWED] 
CHARAC = [] 


>MOU DM1:/OVR/VI 
MOUNT-** VOLUME INFORMATION** 


DEVICE = DMI: 
CLASS = FILE 11 
LABEL = RSXM26 
UIC = [1,1] 
CLASS = [RWED,RWED,RWED,RWED] 
CHARAC = [] 
i 
>i 
; THE SYSTEM I/O EXERCISER WILL RUN FOR 3 MINUT 
re 
>TIM 


13:06:18 06-FEB-79 
>SIO @IOXCNF 


SIO -- DRIVER NOT LOADED 

SIO -- FAILED TO ATTACH UNIT 

SIO -- SUMMARY OF EXERCISER ACTIVITY AT 6-FEB-79 13:09:39 
TIME -~- RUN: 3 MIN. ELAPSED: 3 MIN. REMAINING: 
DBl: -- 7,053. REQUESTS TOTALING 7,053. BLOCKS WITH 
DB3: -- 7,052. REQUESTS TOTALING 7,052. BLOCKS WITH 
DKO: -- 2,348. REQUESTS TOTALING 2,348. BLOCKS WITH 
DK1l: -- 2,341. REQUESTS TOTALING 2,341. BLOCKS WITH 
DMl1: -- 6,547. REQUESTS TOTALING 6,547. BLOCKS WITH 


IDLE-LOOP COUNT: 1,988. ITERATIONS 


ACCUMULATED TOTALS: 


TIME -- RUN: 3 MIN. ELAPSED: 3 MIN. REMAINING: 

DBl: -- 7,053. REQUESTS TOTALING 7,053. BLOCKS WITH 
DB3: -- 7,052. REQUESTS TOTALING 7,052. BLOCKS WITH 
DKO: -- 2,348. REQUESTS TOTALING 2,348. BLOCKS WITH 
DK1: -- 2,341. REQUESTS TOTALING 2,341. BLOCKS WITH 
DM1: -- 6,547. REQUESTS TOTALING 6,547. BLOCKS WITH 


IDLE-LOOP COUNT: 1,988. ITERATIONS 


>REM SIO 
>TIM 
13:10:05 06-FEB-79 


ES 


O MIN. 


ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 


O MIN. 


NO 
NO 
NO 
NO 
NO 


ERRORS 
ERRORS 
ERRORS 
ERRORS 
ERRORS 
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* TEST COMPLETED * 


* UTILITIES VERIFICATION SECTION * 


VVVVV VV v 
me me Ne we te Ns tO Ne 


>RUN DEFINE 


; * CMP VERIFICATION * 


13:10:17 06-FEB-79 
>PIP COMPAR.CMD=SIOE.CMD 
>! INVOKE CMP TO COMPARE IDENTICAL FILES 
>CMP TI:= COMPAR.CMD,SIOE.CMD 
1) COMPAR.CMD;1 
2) SIOE.CMD; 1 


NO DIFFERENCES FOUND 
TI:=COMPAR.CMD ,SIOE.CMD 
>! NO DIFFERENCES SHOULD HAVE BEEN FOUND 
>! 
>! INVOKE CMP TO COMPARE DIFFERING FILES 
>CMP TI:FILE1.,FILE2. 
RKREKEKEKEKEKKKEKEKEKREKREKKEKEKEERKERERKKEKKEERKRERKERAKE 
1) FILE.;1 
6 .; IF CMP IS FUNCTIONING, THIS LINE FROM FILE1. IS DIFFERENT 
7.7 THE REST OF THE LINES ARE IDENTICAL 
RKEKKKEKEKEKKKKEKEK 
2) FILEQ,;1 
6 .; THIS LINE IS THE FILE2, LINE WHICH DIFFERS FROM THE ABOVE. 
7.3; THE REST OF THE LINES ARE IDENTICAL. 


1 DIFFERENCES FOUND 
TI:=FILEL.,FILE2. 
>! ONE DIFFERENCE SHOULD HAVE BEEN FOUND 
>PIP COMPAR.CMD;*/DE 
>; 
>TIM 
13:10:46 06-FEB-79 


>; * CMP VERIFICATION COMPLETE * 


>; * ALL, BAD, INI, MOU, UFD, VFY, DMO, AND DEA VERIFICATION * 


>; THIS ROUTINE CHECKS THE DISK=ACCESSING MCR COMMANDS ALL, BAD, INI, 
+ MOU, UFD, VFY, DMO AND DEA. 

>; ALL AND DEA ARE TESTED ONLY FOR A MULTI-USER SYSTEM. 
7 THIS ROUTINE REQUIRES EITHER ONE DISK DRIVE (OTHER THAN SY:) OR 
7 DECTAPE OR ANSI SUPPORT FOR MAGTAPE. IT WILL NOT USE A PUBLIC 

>; DISK. IF ONLY MAGTAPE IS AVAILABLE, A SUB-SET OF THE TEST IS RUN. 


>INS $BAD 
7 
3 
>DMO DKO: 
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>DEA DKO: 
*** DKO: -- DISMOUNT COMPLETE 


>; *** BE SURE THERE IS A SCRATCH MEDIUM ON DKO: *** 


c 
>* pO YOU WISH TO CONTINUE WITH THIS MODULE ? (Y/N): ¥ 
3 
>INS SVFY/TASK=...VFY 
>ALL DKO: 
>BAD DKO: 
BAD -- DKO: TOTAL BAD BLOCKS= 0. 
SINI DKO:UTIL/BAD= [AUTO] /UIC=[2,300] 
>MOU DKO:UTIL/VI 
MOUNT ** VOLUME INFORMATION ** 


DEVICE = DKO: 

CLASS = FILES 11 

LABEL = UTIL 

vic = [2,300] 

ACCESS = [(RWED,RWED,RWED ,RWED] 
CHAR = [] 


>UFD DKO: [2,300] 
>PIP DKO:=DISK.CMD 
>VFY DKO:/FR 


DKO: HAS 4634. BLOCKS FREE, 166. BLOCKS USED OUT OF 4800. 
>DMO DKO: 


> 
*** DKO: -- DISMOUNT COMPLETE 
>} 
>DEA DKO: 
7 
TIM 
13:12:42 06-FEB-79 
>REM VFY 
>REM BAD 
7 
>; * ALL, BAD, INI, MOU, UFD, VFY, DMO, AND DEA * 
>; * VERIFICATION COMPLETE * 
Pa 
>; * FLX VERIFICATION * 
7 
> 
>INS [1,54] FLX/TASK=...FLX 
>; 2 
; THE FOLLOWING QUESTION WILL BE ANSWERED: DOES FILEX FUNCTION? 
>; 
; THE TAPE ON DRIVE MMO: WILL BE OVER WRITTEN. 
>; 
>FLX MM:/ZE 
FLX -- DEVICE HANDLER MISSING 
>FLX MM: /DO=FI.LEX ,FUNCTI.ONS/RS 
FLX -- DEVICE HANDLER MISSING 
>FLX MM: /LI 
FLX -- DEVICE HANDLER MISSING 
>REM FLX 
>TIM 


13:13:07 O6-FEB-79 
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7 * FLX VERIFICATION COMPLETE * 


i * DMP VERIFICATION * 


13:13:12 O6-FEB-79 
2INS SY:[1,54] DMP/TASK=...DMP 
>DMP TI:=ASRC.XXX/AS/RC 


DUMP OF DB3:[2,300]ASRC.XXX;1 - FILE ID 2171,1,0 
RECORD NUMBER 00. - SIZE 16. BYTES 


000000 DM P WORKS! 


keke FOP kx 


>REMOVE ...DMP 


>TIME 
13:13:24 06-FEB-79 
>} 
>> * DMP VERIFICATION COMPLETE * 
>F 
>; * CREF, PMD, AND PRT VERIFICATION * 

7 
>; THIS ROUTINE OPERATES THE FOLLOWING UTILITIES: 
>; MAC ,TKB,CREF,PMD,PRT 

; 
>; IF ALL ARE FUNCTIONAL, AN EXAMPLE OF A MACRO LISTING WITH SYMBOL 
; AND MACRO CROSS-REFERENCE LISTINGS ATTACHED ARE SPOOLED TO 
>; THE LINE PRINTER, A TASK ARE RUN AND IT CRASHES AND A 

; POST-MORTEM DUMP LISTING OF THE CRASHED TASK IS SPOOLED. 
>} 
>TIM 


13:13:44 06-FEB-79 

>INS [1,54] CRF/TASK=...CRF 

>i 

>MAC CRTEST,CRTEST/CR/-SP=CRTEST 
>TKB CRTEST/PM=CRTEST 


>; 
>PIP CRTEST.LST/SP 
PIP -- FAILED TO SPOOL FILE FOR PRINTING 


DB3:[2,300] CRTEST.LST; 4 
>; 


t 
RUN CRTEST 
> 
>REM CRF 
TASK “TTO "TERMINATED 
ODD ADDRESS OR OTHER TRAP FOUR 
PC=001236 
PS=170001 
RO=000000 
Rl=111111 
R2=022222 
R3=033333 
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R4=044444 
R5=055555 
SP=001172 
POST MORTEM DUMP WILL BE GENERATED 


>TIM 
13:14:10 O06-FEB-79 


>; * CREF, PMD AND PRT VERIFICATION COMPLETE * 


ba * DSC VERIFICATION * 


13:14:38 06-FEB-79 
>SET /UIC=[2,300] 


; BECAUSE YOU DO NOT HAVE A FLOPPY DRIVE OR DEC TAPE, 
: AN AUTOMATIC VERIFICATION OF DSC OPERATION IS DEEMED 
3} IMPRACTICAL. 

; THE DSC TEST IS BEING SKIPPED. 


‘ 
>PIP *.TMP;*/DE 
PIP -- NO SUCH FILE(S) 
SY0:[2,300]*.TMP;* 


; * LBR VERIFICATION *_ 


13:14:52 06-FEB-79 

>INSTALL SY:[1,54] LBR/TASK=...LBR 

>; Create an object module library. 

>LBR OBJ LIB/CR::::0BJ 

>! Insert three object modules into the library. 

>LBR OBJ LIB/IN=OBJCT1 ,OBJCT2 ,OBJCT3 

>! Insert an existing module into the library (error expected). 
>LBR OBJLIB/IN=OBJCT2 

LBR -- *FATAL*-DUPLICATE MODULE NAME "OBJ2 "IN OBJCT2.OBJ;1 


>! Replace two existing modules. 
>LBR OBJLIB/RP=OBJCT1 ,OBJCT2 
MODULE "OBJ1 " REPLACED 


MODULE "OBJ2 " REPLACED 


>! Display. the contents of the object module library. 
>LBR OBJ LIB/LE/FU 

DIRECTORY OF FILE OBJLIB.OLB;1 

OBJECT MODULE LIBRARY CREATED BY: LBR V06.00 

LAST INSERT OCCURRED 6-FEB-79 AT 13:15:27 

MNT ENTRIES ALLOCATED: 256; AVAILABLE: 253 

EPT ENTRIES ALLOCATED: 512; AVAILABLE: 506 

FILE SPACE AVAILABLE: 21897 WORDS 

RECOVERABLE DELETED SPACE: 00150 WORDS 


** MODULE:OBJ1 SIZE:00075 INSERTED:6-FEB-79 IDENT:ID 1 


ENTSAL ENTSB1 
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** MODULE:0OBJ2 8IZE:00075 INSERTED:6-FEB-79 IDENT:ID 2 


ENTSA2 ENTSB2 


** MODULE:0BJ3 SIZE:00075 INSERTED:6-FEB-79 IDENT:ID 3 


ENTSA3 ENTSB3 


>PIP OBJLIB.*;*/DE 
>REMOVE ...LBR 


>TIME 
13:15:59 06-FEB-79 
; * LBR VERIFICATION COMPLETE * 
; 
; * PAT VERIFICATION * 
i 
>TIME 


13:16:04 O6-FEB-79 
>INSTALL [1,54] PAT/TASK=...PAT 
>! Create an updated object file. 
>PATCH PATCHD.PAT=OBJCT1 ,PATCH1 
>! Compare the updated object file with one of known quality. 
>CMP TI:=PATCHD.PAT,PATCHD.XXX 
1) PATCHD.PAT;1 
2) PATCHD.XXX;1 


NO DIFFERENCES FOUND 
TI:=PATCHD.PAT,PATCHD.XXX 
>PIP *,PAT;*/DE 
>REMOVE ...PAT 


>TIME 

13:16:22 06-FEB-79 
i * PAT VERIFICATION. COMPLETE * 
; 

>} * SLP VERIFICATION * 
7, 

>TIME 


13:16:27 O06-FEB-79 
>INSTALL [1,54] SLP/TASK=...SLP 
>! Invoke the SLP Editor to edit a data file. 
>SLP @SLPCMD ! "SLP OUTPUT.SLP,LIST.SLP/-SP=SLPDAT.XXX" 
>! Verify that the editing was properly performed. 
>CMP TI:s=OUTPUT.SLP,SLPOUT.XXX 
1) OUTPUT.SLP;1 
2) SLPOUT.XXX;1 


NO DIFFERENCES FOUND 
TI:=OUTPUT.SLP,SLPOUT.XXX 
>PIP *.SLP;*/DE 
>REMOVE ...SLP 


>TIME 
13:16:46 06-FEB-79 
i * SLP VERIFICATION COMPLETE * 
; 
>; * INTERACTIVE UTILITIES VERIFICATION * 
; 
? ENTER A CHARACTER TO CONTINUE FROM EACH 
; EDITOR SUCCESSFULLY INVOKED AND CTRL Z TO EXIT FROM ACNT. 
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>TIM 

13:16:57 06-FEB-79 
>EDI QQQQ.XXX 
[CREATING NEW FILE] 
INPUT 


>ABO EDI 


TASK “...EDI" TERMINATED 
ABORTED VIA DIRECTIVE OR MCR 
>; 
>PIP QQQQ.XXX;*/DE 
>? 
>INS [1,54] EDT 
>EDT 
EDT> 
>ABO EDT 


TASK "...EDT" TERMINATED 
ABORTED VIA DIRECTIVE OR MCR 
73 

>REM EDT 


>ABO ZAP 
TASK "...ZAP" TERMINATED 

ABORTED VIA DIRECTIVE OR MCR 

>INS [1,54] ACNT/TASK=ACNT 

>RUN ACNT 

* ACCOUNT FILE MAINTENANCE PROCEDURE * 

OPTIONS ARE: A - ADD, C - CREATE, D - DELETE, E - EXAMINE, 
L - LIST, M - MODIFY, S - SORT, CTRL/Z - EXIT 

ENTER OPTION: “Z 
OPERATION COMPLETE 


> 
>REM ACNT 
>TIM 
13:17:22 O6-FEB-79 
>; 
>? * INTERACTIVE UTILITIES VERIFICATION COMPLETE * 
>3 
>UNL MM: 
UNL -- DRIVER NOT LOADED 
>PIP *.DAT;*/DE 
>} 
; IF ANY ERRORS HAVE BEEN LOGGED BY ERROR LOGGER, WHEN THE COMMAND FILE EXITS 
>; YOU SHOULD PRINT SY:[2,300] ERRLOG.LST AND INVESTIGATE THE ERRORS. 


3 

>ERF 

ERF -- REQUESTED "“ERRLOG" TO STOP LOGGING 
ERL -- LOGGING ENDED AFTER 9 ERRORS 


>INS LB:$PSE 

>INS LB:SSYE 

INS -- PARTITION PAR1L4K NOT IN SYSTEM, DEFAULTING TO GEN 
> 

>PSE SY:=SY: 

>SYE SY:=SY:/-SP 


>; 

>RUN ERRLOG 

ERL -- ERROR LOG INITIALIZED 
> 

>3 

>REM PSE 


10-13 


INSTALLATION VERIFICATION PROCEDURE 


>REM SYE 


; IF YOU WANT TO REMOVE FROM THE SYSTEM ALL FILES ASSOCIATED 

: WITH THIS PROCEDURE, ANSWER THE FOLLOWING QUESTION WITH N. 

; THE ANSWER Y (FOR “YES, SAVE") LEAVES THE TASK, DEFINE, 

; INSTALLED. ALL NECESSARY FILES REMAIN ON THE SYSTEM DISK TO 
3; ENABLE A REPEAT RUN. 
>* DO YOU WISH TO SAVE THE PROCEDURE TO RUN AGAIN? [Y/N] :¥ 


>; HHI IRI KIER EIA IKEEEEEERERERERERREKREEREEEEEREREREREEEEEEKEREKERER 


13:18:07 O6-FEB-79 

>7 

>; **k* END OF RSX-11M V3.2 INSTALLATION VERIFICATION *** 

>: 

>; KKK KIKI KIRA ERRATA EERE ERR EERE EEEREREEREREKEREKKKEK 
>/ 

>@ <EOF> 

> 


10.5 ERROR CODES 


The following text is a compilation of the error codes produced by the 
various modules in the RSX-11M Installation Verification Procedure. 
All the modules print an error number that is either the contents of 
F.ERR(RO) for I/O errors or S$DSW for Executive directive status codes. 


DEFINE.TSK - System Configuration Module 


When an error occurs, DEFINE.TSK prints "DEFINE ERROR # nn ccc", where 
nn is the number of the error and ccc is the contents of F.ERR(RO) for 
I/O errors or $DSW for Executive directive status. Both F.ERR-= and 
$DSW appear in octal word format. Therefore, when the high-order byte 
shows as a minus one, it indicates that the error is from an Executive 
directive. The number of the error refers to the instruction that 
caused it. Below is a list of possible error numbers and their 
meanings. 


ERROR # DEFINITION 

1 OPENSW - OPEN TO CREATE CONFIG.CMD FILE FAILED 

2 OPENSR - OPEN FILE TAILOR.DAT FOR READ (FDB=FDTAIL) 
FAILED 

3 READS - READ OF FILE TAILOR.DAT FAILED (FDB=FDTAIL) 

4 WAITS - WAIT FOR FILE TAILOR.DAT (FDB=FDTAIL) 
FAILED 

5 CLOSES - CLOSE OF FILE TAILOR.DAT (FDB=FDTAILL) 
FAILED 

6 CLOSES$ ~ CLOSE FAILED FOR CONFIG.CMD FILE 

8 PUTS - OUTPUT TO CONFIG.CMD FILE FAILED 

19 EXITSS - EXIT FAILED 


LOGGER.TSK - Monitoring Task for QT Load Tasks 


When an error occurs, LOGGER.TSK prints "LOGGER ERROR # nn ccc", where 
nn is the number of the error and ccc is the contents of F.ERR(RO) for 
I/O errors or of $DSW for Executive directive status. Both F.ERR and 
$SDSW appear in octal word format. Therefore, when the high-order byte 
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shows as a minus one, it indicates that the error is from an Executive 
directive. The number of the error refers to the instruction that 
caused it. Below is a list of possible error numbers and their 
meanings. 


ERROR # DEFINITION 
1 OPENSW - Failure of open for write to RUNLOG.DAT 
file. 
2 OPENSW - Failure of open for write to ERRLOG.DAT 
file, 
3 PUTS - Failure of write to ERRLOG.DAT or RUNLOG.DAT 
file. 
4 PUTS - Failure of write to ERRLOG.DAT file. 
5 PUTS ~ Failure of write to ERRLOG.DAT or RUNLOG.DAT 
file. 
6 PUTSR - Failure of write to RUNLOG.DAT or ERRLOG.DAT 
file. 
7 WSIGSS - Wait for significant event directive failure. 
10 RCVDSC - Receive data directive failure. 
11 ALUNSS - Assign LUN directive failure. 
12 WTSESC - Wait for significant event directive failure. 
13 SETFSS - Set event flag directive error. 
14 SDATSS - Send data directive failure. 
15 CLOSES - Close failure of RUNLOG.DAT or ERRLOG.DAT 
file. 
16 GTIMSC - Get time directive failure. 
17 CLEFSS - Clear event flag directive failure. 


NUL1.TSK - One Form of the QT Load Tasks 


When a directive error occurs, the QT load task prints "TASK QTnn 
ABORTING", where nn is the task number that identifies the specific 
task. The module then displays an error identifying number as "ERROR 
# n". It then displays the octal error code found in $DSW. The error 
codes in $DSW are defined in the RSX-11M/M-PLUS Executive Reference 
Manual or the RSX-11M Mini-Reference. Below is a list of possible 
error numbers and their meanings. 


ERROR # DEFINITION 

0 SPNDSS - Suspend directive issued by QT task failed. 

1 RCVDSC ~ Receive Data directive failed (receive from 
CONFIG). 

3 ALUNSS - Assign Logical Unit Number directive failure 
to use TT# received from CONFIG.TSK 

4 MRKTSC - Mark Time directive failure. 

5 EXIFSS - Exit directive failure. 

6 DSCPSS - Disable Checkpointing directive failure. 

7 SDATSS - Send Data directive failure (send to LOGGER 


before exiting). Insufficient dynamic 
memory can cause this error, 
ASTXSS - AST Service Exit directive failure. 
CLEFSC. - Clear Event Flag directive failure. 


QTRUN.TSK - Start Up the QT Load Tasks 
When an error occurs, QTRUN.TSK prints "QTRUN ERROR # nn ccc", where 


nn is the number of the error and ccc is the contents of F.ERR(RO) for 
I/O errors or of S$DSW for Executive directive status. Both F.ERR and 
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$DSW appear in octal word format. Therefore, when the high-order byte 
shows aS a minus one, it indicates that the error is from an Executive 
directive. The number of the error refers to the instruction that 
caused it. Below is a list of possible error numbers and their 
meanings. 


ERROR # DEFINITION 
1 OPENSW - Open failure on DVLREM.CMD or DVLSET.CMD 
file. 
2 OPENSR - Open failure on TAILOR.DAT file. 
3 READS - Read failure on TAILOR.DAT file. 
4 WAITS - Wait failure on TAILOR.DAT file. 
5 CLOSES - Close failure on TAILOR.DAT file. 
6 CLOSES - Close failure on DVLSET.CMD file or 
DVLREM.CMD file. 
7 GPRTSC ~ Get Partition Parameters Executive directive 
failure. 
8 PUTS - Write failure for .CMD files created by 
QTRUN. 
9 RSUMSS ~ Resume Executive directive failure for DUMMY 
task. 
10 RQSTSS - Request Executive directive failure for 
LOGGER task. 
13 WSIGSS - Wait for Significant Event Executive 
directive failure. 
14 RSUMSS - Resume Executive directive failure. 
15 ROSTSS - Request Executive directive failure. 
16 SDATSS - Send Data Executive directive failure 
(failure of Send Data to QT task). 
17 SDATSS —~ Send Data Executive directive failure 
(failure of Send Data to Logger task). 
18 RSUMSS - Resume Executive directive failure. 
19 EXITSS - Exit Executive directive failure. 
20 GTIMSC - Get Time Executive directive failure. 
21 ALTPS$C - Alter Priority Executive directive failure 


(alteration of indirect command file 
processor failed). 
22 MRKTSC - Mark Time Executive directive failure. 
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CHAPTER 11 


SYSGEN ERROR MESSAGES 


All messages from SYSGEN appear in this chapter in alphabetical order. 
The descriptions that follow each message explain the possible cause 
and, aS necessary, suggest remedial action. 


SGN -- Attempt to use non-existent default for parameter parm -- RETRY 


Explanation: A required parameter (number "parm") was missing 
from the response to the current peripheral question. Reenter 
the entire response. Note that the [L/R] parameter does not 
count. 


SGN -- Baseline terminal driver not valid option with multiuser 
protection selected. 


Explanation: The half duplex baseline terminal driver includes 
no SYSGEN options and cannot execute in a multiuser protection 
system (for example, breakthrough write is required but not 
included). Choose a different terminal driver, 


SGN -- CO driver not valid on RSX-11S systems -- SUPPRESSED 


Explanation: RSX-11S systems cannot include the console driver 
(CO). SYSGEN ignores this entry. 


SGN -- cb driver not valid on unmapped system -- SUPPRESSED 


Explanation: Unmapped systems cannot include the console driver 
(CO). SYSGEN ignores this entry. 


SGN -- Correct problems and reassemble the bad modules SYSGEN will 
continue when done. 


Explanation: This message indicates that you detected an error 
in assembling the Executive or the device drivers (you responded 
No at either the Executive or driver EOX breakpoint). After you 
correct the error, reassemble the bad modules and SYSGEN will 
continue. 


SGN -- Correct problems -~ SYSGEN will restart assemblies when done 
Explanation: This message indicates that you detected an error 
in assembling the laboratory peripheral devices. After you 


correct the error, SYSGEN will attempt to re-assemble the 
laboratory peripherals common area(s). 
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~- DM11-BB CSR address must be greater than 157777 if 
specified -- RETRY 


Explanation: If the system includes a DM11-BB, the CSR address 
must be greater than or equal to 160000. If not included, the 
CSR address must be zero. 


-- DM11-BB vector address must be greater than 277 if 
specified -- RETRY 


Explanation: If the system includes a DM11-BB, the interrupt 
vector address must be greater than or equal to 300. If not 
included, the vector address must be zero. 


-- Dynamic storage space must be in multiples of two 
words -- RETRY 


Explanation: The system allocates pool in 4-byte sections. 
Thus, the amount of pool must be a multiple of 4 bytes. 


-- GR not valid on system with more than 124K -- SUPPRESSED 


Explanation: The graphics display driver (GR) does not execute 
on 22-bit processors. If your system includes a GR, the maximum 
amount of memory is 124K. If you have a GR and wish to use it, 
type CTRL/Z and restart specifying 124K or less for memory size. 


-- Illegal character in numeric response -- RETRY 


Explanation: A character other than 0-7 for an octal response or 
0-9 for a decimal response was entered. Note that the use of 
special characters (# or .) to indicate an explicit octal or 
decimal response is forbidden. 


~- Illegal device mnemonic 
Explanation: This message applies only to dual RKO5 kit users 
that answered Y to question 9 (skip end of disk (EOD) 
breakpoints). If you wish to ignore EOD breakpoints, you must 
enter the device that contains the driver source files. The 
message indicates that you incorrectly specified the driver 
source device; enter a minimum of two characters. 
-- Illegal device mnemonic -- RETRY 
Explanation: You specified a drive type that the device does not 
support (such as RPO6 for a DL device). 


-~ Illegal numeric answer -- RETRY 


Explanation: See the description of Illegal character in numeric 
response. 
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-- Illegal printer specification -- valid types are LPll1-C, D, F, 
H, J, K, R, S, V, W, Y, Z, LS11, LA180, and LV1l1 -- RETRY 


Explanation: SYSGEN only supports the above named line printer 
controllers. If you have a different controller, refer to the 
peripheral question concerning LP: to match your printer 
characteristics with a DEC standard printer. 


- Illegal trailing characters or extra parameters "parm" -- RETRY 


Explanation: You have specified more parameters than allowed for 
this response. Remember that Parameters in brackets can only be 
specified for the first controller of this type. 


-- Invalid directive code "direc-code" 

Explanation: You have entered other than A, B, C, D, E, F, G, H, 
I, or %. The line is discarded. 
-~ Invalid system device -- RETRY 


Explanation: The device specification for the Executive source 
disk was improperly or incorrectly entered. 


Big disk kits: The default response is S¥:; enter either Y or 
carriage return. Otherwise, you must enter at least two 
characters to identify the device that contains the Executive 
sources, 


Dual RK or RLO1 kits: There is no default response to this 
question, Enter the device (minimum two characters) that 
contains the Executive sources. 
-- Listing files cannot be sent directly to LP: -- RETRY 
Explanation: Spooled listings must go to a real device. Also, 


for online SYSGENs, maps cannot go directly to the line printer. 
If you want to print at LP:, specify LPO:. 


-- Loadable driver support was not selected in the Executive 
section of SYSGEN. Device cannot be made loadable -- RETRY 


Explanation: You did not include loadable driver Support in the 
system. All device drivers must be resident. 


-- Loadable/Resident indication not valid for this device —- RETRY 
Explanation: Loadable or resident ig not an option for this 
device. 

-- Maps cannot be sent directly to line printer -- RETRY 
Explanation: Spooled maps must first go to a spool device. 


Also, for online SYSGENs, the maps cannot go directly to the line 
printer (specify LPO:). 
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-- Maximum of 1 CRT monitor possible with VT11 -- RETRY 
Explanation: A VS60 can support two CRT monitors, but a VTll 
supports only one. 

-- Maximum of 8 printers allowed on a system with a KMC -~ RETRY 


Explanation: The KMC-11 supports up to eight line printers. 


-- Maximum of nn. controllers allowed for device dd -- RETRY 
Explanation: The specified device supports nn controllers. Note 
that pseudo devices can only indicate one controller. Terminal 
driver hardware controllers are specified later. 

-- Memory size inconsistent with mapping option 
Explanation: The maximum memory size for an unmapped system is 
28K-words. The minimum memory size for a mapped system is 
24K-words. You have either specified (in question 4, Memory 
size) more than 28K-words of memory for an unmapped system 
(question 5) or less than 24K-words of memory for a mapped 
system. 

-- Memory not multiple of 4K 
Explanation: When you specify memory size, it must be an even 
multiple of 4. 

-- More than 252. modules specified -- RETRY 
Explanation: The UDC-11 supports a maximum of 252 modules. You 
have specified more than the maximum. 

-- Number of interrupts must be divisible into 10,000. 
Explanation: The number of interrupts per second for the KW11-P 
clock was not 1, 2, 4, 5, 8, 10, 16, 20, 25, 40, 50, 80, 100, 
125, 200, 250, 400, 500, 625, 1000, 1250, 2000, 2500, or 5000. 
Note that more than 100(10) clock interrupts per second 
significantly increases system overhead. 


-~ Number of samples must be evenly divisible into 10000. -- RETRY 


Explanation: Sampling rate must be evenly divisible into 10000. 


-- Overlapping modules -- RETRY 
Explanation: The last module specified attempts to use slots 


that you have indicated occupied by other modules. Review your 
configuration and try again. 
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-- Parameter (#N) "parm" out of range n to n -- RETRY 

Explanation: The indicated parameter (excluding 
Loadable/Resident) is not within the acceptable range. 

-- Pausing to allow copying of [ggg,10] files to baseline disk 


Explanation: This message applies to RLO1 kit users only. 


-- Pausing to allow editing of Executive source 


Explanation: This is not an error message; the message is 
informative. It indicates that you wish to edit Executive files. 


-- Pausing to allow loading of EXCSRC disk 


Explanation: This message applies to dual RKOS kit users only. 
The message indicates that SYSGEN will pause while you load the 
EXCSRC disk into the proper drive. 


~~ The full duplex terminal driver requires memory Management and 
loadable driver support. If you desire the full duplex driver, 
you must repeat the Executive questions and select these options. 


Explanation: As the message states, you must include memory 
management directives (PLAS) and loadable driver support to 
select the full duplex terminal driver. 


-- Unable to determine system type -- assuming unmapped 
Explanation: This message applies to RLO1 kit users only. When 
you generate a mapped system, you must use a mapped system. 
Likewise, when generating an unmapped system, use an unmapped 
system. This message indicates that the system UIC has been 
changed and does not end in 0 or 4; SYSGEN must choose. 


~- Unit number must be an integer in the range 0 to 7 


Explanation: The crash device must be unit number 0-7 inclusive. 


~- Unrecognizable string "ddn" -- Ignored 

Explanation: SYSGEN could not parse the indicated string. 
Perhaps you omitted a comma. 
-- Valid char detec expan unit indics. are "C" (yes) and "NO" 
(no) -- RETRY 


Explanation: Valid responses for this paramter are C, to 
indicate that controller includes character unit, and NO, to 
indicate it does not. 
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-~ Valid D/A present indicators or "Dp" (yes) and "NO" 
(no) -- RETRY 


Explanation: Valid responses for this parameter are D, to 
indicate that controller includes D/A converter, and NO, to 
indicate that it does not. 


-- Valid devices: DT, DK, MT, MS, MM, DB, DM, DL, DD, & 
DR -- RETRY 


Explanation: The CDA routine does not support the device you 
entered as a dump device. 


-- Valid DR11-K present indicators are "DRK" (yes) and "NO" 
(no) -- RETRY 


Explanation: Valid responses for this parameter are DRK, to 
indicate that DR11-K is present, and NO, to indicate that it is 
not. 


-- Valid duplex indicators are "H" and "F" -- RETRY 
Explanation: Valid responses for this parameter are H, to 


indicate a half duplex line, and F, to indicate a full duplex 
line. 


-- Valid err detec expand unit indics. are "E" (yes) and NO 
(no) -- RETRY 


Explanation: Valid responses for this parameter are E, to 


indicate that error detection expander unit is present, and NO, 
to indicate that it is not present. 


-- Valid indicators are "H", "F", and "P" -~ RETRY 


Explanation: Valid responses for this parameter are H, to 


indicate half duplex line, P, to indicate primary station of 
line, and F, to indicate full duplex line. 
~- Valid graphic device indicators are "VT11" and "VS60" -- RETRY 
Explanation: Valid responses for this parameter are VT11, to 


indicate a VTll graphics display device, and VS60, to indicate 
VS60 graphics display device. 


-- Valid line speeds are 50, 75, 110, 134.5, 150, 200, 300, 600, 
1200, 2400, 4800, and 9600 -- RETRY 


Explanation: The controller does not support the specified line 
speed. 
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-- Valid listing devices ares: SY:, TI:, and "None" 
(default) -- RETRY 


Explanation: When performing an RSX-11S system generation using 
an IAS host system, the listing device must be SY: or TI:. 


-- Valid map devices are: SY:, TI:, and "None" (default 
SY:) -- RETRY 


Explanation: When performing an RSX-11S system generation using 
an IAS host system, the map device must be SY: or TI:. 


-- Valid offset recovery indicators are "0" (yes) and "NO" 
(no) -- RETRY 


Explanation: Valid responses for this parameter are O, to 
indicate that all of this controller type support offset 
recovery, and No, to indicate that none of the controllers of 
this type support it. 


~~ WARNING ~- CPU does not have switch register -- Get sense 
switch directive not included 


Explanation: The processor you specified does not have a switch 
register. Thus, you cannot use the get sense switch directive. 
If you wish to include the directive, edit RSXMC.MAC and add the 
line GS$STSS=0. 


~- WARNING -~ Null device forced into system 


Explanation: This message indicates that SYSGEN has forced the 
null device into your configuration. The null device is required 
to redirect data normally sent to either the system disk or the 
terminal driver (both of which your system does not include). 


~~ WARNING -- Terminal driver forced into configuration 


Explanation: RSX-11M requires a terminal driver for operation. 
You forgot to specify a terminal driver so SYSGEN put one in for 
you. Later, SYSGEN will ask which terminal driver you want to 
use, 
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SYMBOLS FOR SAVED ANSWER FILES 


Definition 
Processor type (for example "11/60") 


Processor has a switch register 
Processor does not have a switch register 


Generating RSX-11S 
Generating RSX-11M 


Memory size in K-word blocks 


Generating mapped system 
Generating unmapped system 


System includes K-series laboratory peripherals 
System does not include K-series laboratory 
peripherals 


System includes extended arithmetic element 
System does not include extended arithmetic 
element 


System includes floating point processor 
System does not include floating point processor 


System includes floating instruction set 
System does not include floating instruction set 


Number of KW11-P clock interrupts/second (0 
excludes KW11-P) 


Line frequency (A=60Hz, B=50Hz) 


System includes KW11-Y watchdog timer 
System excludes KW11-Y watchdog timer 


System includes memory parity support 
System excludes memory parity support 


System contains cache memory 
System does not contain. cache memory 


Highest interrupt vector address (if highest 
vector specified or less than 400, SYSGEN 
recalculates; $HIV not saved until peripheral 
section is complete) 


Peripheral devices and number of controllers 


Symbol 
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Definition 


Peripheral devices and number of controllers 
Peripheral devices and number of controllers 


Online SYSGEN 
Standalone SYSGEN 


Host includes a line printer 
Line printer not available on host 


"/SP" spool listings and maps, 
"/-SP" do not spool 


Printer width at least 120 columns 
Printer width less than 120 columns 


Device mnemonic for assembly listing files 


trailing ":", S¥: is "" 


Device mnemonic for Executive and device 
maps 


DBMS-11 support 
No DBMS-11 support 


Files-1l1 ACP support 
No Files-ll ACP support 


Record Management System support 
No RMS support 


Non-resident task support 
No task loader support 


Loadable task loader 
Resident task loader 


Memory management directives support 
No PLAS support 


Send/receive by reference support 
No send/receive by reference directives 


Get mapping context support 
No get mapping context directive 


Address checking support 
No support 


I/O rundown support 
No support 


Multiuser protection support 
No support 


ANSI magtape support 
No support 


Online formatting and user-mode diagnostic support 


No support 


Loadable driver support 
Resident drivers only 
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Definition 


All loadable drivers loadable 
All loadable drivers (except full duplex 
built as resident 


AST support 
No support 


TKTN support 
No Support 


Power fail recovery support 
No support 


Install-run-remove on exit support 
No support 


20K Executive 
16K Executive 


Logical device assignment support 
No support 


Log device errors and interrupt timeouts 
No logging 


Log undefined interrupts 
No logging 


Log memory parity errors 
No logging 


System to include user-written driver 
No user-written drivers 


System includes get word Executive routine 
System excludes get word Executive routine 


System includes put word Executive routine 
System excludes put word Executive routine 


System supports disk writecheck 
No support 


System supports Executive Debugging Tool 
No XDT 


Rotating data lights 
No rotating lights 


Industrial network and DECnet support 
No network support 


System supports queue manager 
No queue manager 


Group global event flag support 
No support 
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Definition 
Executive directives code: "ABCDEFGHI” 
(A= get partition parameters, B= get task 
parameters, C= send/receive, D= alter priority, E= 


extend task, F= connect to interrupt vector, G= 
get sense switch, H= parent/offspring tasking, I= 
stop bit) 


Number of pre~allocated QIO packets (0= no QIO 
speed optimizations) 


Size of data transfer vector in words (if S$NPK=0, 
SDTV=0) 


Round-robin scheduling interval (0 excludes 
round-robin scheduler) 


Highest priority class for round-robin scheduling 
(if S$RRS=0, $HIC=0) 


Lowest priority class for round-robin scheduling 
(if SRRS=0, SLOC=0) 


Swapping interval for Executive level disk 
swapping (0 excludes Executive level disk swapping 
support) 


Executive level disk swapping range (swapping 
priority) (if S$DKS=0, SSWP=0) 


Size of dynamic storage region (pool space) 


Seconds between line printer not ready messages (0 
suppresses messages) 


Seconds between card reader not ready messages (0 
suppresses messages) 


CSR address for register and stack dump device (0 
excludes stack and register dump following crash) 


Checkpointing (A= checkpointing, B= checkpointing 
with system checkpoint file, empty string = no 
checkpointing support) 


System controlled partitions (A= system 
controlled, B= with the shuffler, empty string = 
no system controlled partitions) 


Dump routine (A= PANIC, B= CDA, empty string = no 
memory dump routine) 


CSR address for CDA crash notification device (if 
SCRA not equal B, SNOT not in file) 


Device mnemonic for CDA memory dump (if $CRA_ not 
equal B, $MDD not in file) 


CSR address of CDA dump device (if $CRA not equal 
B, SMDC not in file) 


CSR address of PANIC dump device (if SCRA not 
equal A, $PDD not in file) 


Symbol 
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Definition 


Terminal driver (A= tailorable half duplex, B= 
user oriented half duplex, C= full duplex, D= 
baseline half duplex) 


Timeout value (if STTY not equal C, S$TMN not in 
file) (0 excludes support for unsolicited input 
timeout feature) 


Pass form feeds directly to terminal 
Convert form feeds into 8 line feeds 


Support automatic carriage return/line feed 
No support 


Task checkpointable during terminal input support 
No support 


AST on unsolicited input character 
No support 


CTRL/O cancellation support 
No support 


Breakthrough write support 
No support 


CTRL/R support 
No support 


Process escape sequences 
No support 


Get multiple characteristics support 
No support 


Set multiple characteristics support 
No support 


Get terminal driver options support 
No support 


Hold screen mode support 
No support 


Transparent read write support 
No support 


Settable case conversion support 
No lower to upper case conversion 


Read after prompt support 
No support 


Read with no echo support 
No support 


Read with special terminator support 
No support 


CRT rubout support 
No backspace deletion 
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Definition 


CTRL/S and CTRL/Q support 
No support 


User terminal input buffer support 
No support 


Variable length terminal input buffer support 
No support 


System includes LA30P 
No LA30P 


Hardware unrecoverable input error support 
No support 


Device independent cursor positioning support 
No support 


Pause to allow editing Executive files 
Do not pause 


Assembly listing device ready 
Assembly listing device not ready 


Assembly listing device must be initialized 
Device is initialized 


Assembly listing device label 


Mount assembly listing device 
Need not mount device 


Create listing UFD 
Do not create listing UFD 


Allow direct access to IP11/IP300 device registers 


Do not allow direct access 


Allow direct access to ICS/ICR modules 
Do not allow direct access 


Allow direct access to UDC1ll modules 
Do not allow direct access 


Edit RSXMC to allow FORTRAN access to laboratory 


device registers 
Do not edit 


SYMBOLS FOR SAVED ANSWER FILES 


Format of Saved Answers for Devices 


Controller: 
Nea’ . 
$$ [device~mnemonic] [controller number] 
For example: 
? ~SETS $SMMO spe 
Unit modifiers: 
$[controller number] [device-mnemonic] [unit number] 
For example: 
-SETN $OMMO 0 
SETS sopyl "DOUBLE" 
we’ 
r : 
% i 
s 


APPENDIX B 


RMDEMO 


B.1 INTRODUCTION 


RMDEMO is a privileged task that displays information concerning task 
activity in an RSX-11M system. The display usually runs continuously 
on a video terminal, such as the VTO5B or the VT52. A single 
"snapshot" display can be run ona hard-copy terminal, such as an 
LA36. The display format adapts automatically to the type of terminal 
on which it runs. 


Typically, RMDEMO is set running on ae slaved terminal near the 
computer as part of the system boot procedure. Individual users can 
also display RMDEMO on their terminals using the MCR command >RMD. 


RMDEMO should be installed under the name ...RMD for these commands to 
work, 


The display features include: 

1, Current date and time; 

2. The currently active task; 

3. All tasks, loaded drivers, and common blocks currently in 
memory, displayed in a graphic fashion to show their 
individual memory requirements and locations relative to 
other tasks; 

4. The number of active tasks currently in memory, the number 
not currently resident, and the total amount of memory 
occupied by each group; 

5. The current amount of available system dynamic memory (pool 
space), including the largest available block and the number 
of fragments; and the worst case of pool space since 
bringing up RMDEMO; 

6. A graphic display of partition information; 


7. The number of free blocks available on the system device and 
three or more additional mounted FILES-11 volumes; 


8. The system error count Sequence. 


RMDEMO 


RMDEMO scales the display to the memory size of the computer on which 
it is executed. The amount of memory displayed on the screen will 
always be the next largest multiple of 32 words. (In certain 
instances, this may cause an inaccurate amount of total memory to 
appear. For example, a 28K system running RMDEMO on an LA36 will 
display somewhat over 29K of total memory. This anomaly in a rare 
case was considered preferable to the alternative, which was to reduce 
resolution in the display.) 


Task locations and sizes displayed by RMDEMO should be considered 
approximate. RMDEMO is primarily designed to provide a visual display 
and system debugging tool. It does not accurately measure task size 
and location. 


B.2 HARDWARE REQUIREMENTS 


RMDEMO runs on RSX-11M and RSX-11S. It is non-overlaid and requires 
approximately 5K. 


B.3 BENEFITS OF USING RMDEMO 


In general, RMDEMO is a useful task designed to allow either an 
operator or user to view the current state of the operating system. 
The information is presented in a graphic, easily comprehensible form. 


There are a number of specific instances in which RMDEMO can help to 
locate certain system lockout problems or bugs in application and/or 
system-level software. 


1. Bugs and other situations that cause exhaustion of system 
dynamic memory (resulting in unexplained system hangs) may be 
detected and more easily reproduced and diagnosed. 


2. Task checkpointing and swapping may be monitored -- and in 
systems with limited memory, deadlock conditions may often be 
more easily diagnosed. 


3. Free space on a number of FILES~-11 devices may be monitored 
in real time, which may help in situations where online 
storage is at a premium or where some program is running 
wild. 
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B.4 RMDEMO DISPLAY FIELDS 


RSX-L1M V3.2 BL26 wlan 2l~JUN@79 L1i52242 
KIPLEK POOL#1386.22686.%49, FREE#S YO? 39056. 0812178940. 
1386,.32686.%49. DH2368928. DERSI30857. FARS 


TN? TMDUME FC M FF, ti t 
La TCRMA OO T 3 : 


LOR tk 


1S ROO 3210010200019 SIE 2870060 721K AIK 


+ 
e 


Tie EK & ‘ TTPAR tT 
<3 OTAL, O 2 : SYSPARIT 
The Aan FF T 
fC. Ct ¢ ¢ E 


sn fs Pe PN (ene DPove nee ser can te 0 8 a Ht I et HE Et 


256310028 010032 OO 35 2701058 4 100K 41 630K 4 4 BIOIOK A BOHR 


ERRSEQ 
Bee 


Figure B-l Example of RMDEMO Display 
The version number of the current system, base level, and 
memory size. 
The current date and time. 


The currently executing task; *IDLE* indicates that no task 
is executing (the Executive is executing the idle loop). 


Pool information in the format POOL=X:Y:2 where the first 
line is: 


size in words of the largest free block in pool; 
total number of free words in the pool; 
number of fragments in the pool free list. 


Xx 
Y 
Z 


and the second line records the worst case of pool since’ the 
current execution of RMDEMO began. (This second line will be 
most useful on a slaved terminal that is started displaying 
RMDEMO when the system is booted. Otherwise, this second 
line gives worst-case pool information from the time you 
initiate the RMDEMO display on a terminal.) 


The number of free blocks on SY0: and up to 3 more’ selected 
FILES-11 devices. 


Number of active tasks in memory and the amount of memory 
they occupy, plus the number of active tasks checkpointed out 
(not in memory) and the total memory they would require. 


The name of each task in memory and a representation of other 
information about the task, including size. 


< > active task 
[ ] task not active, yet occupies memory 
! ! named common 


10. 


ll. 


RMDEMO 


+ + unnamed common, name displayed is first 
attached task 

( ) loaded loadable driver, name displayed is 
device mnemonic (see next entry) 

----- task is not fixed in memory 

===s== task is fixed in memory 


The hyphens ( -) or equals ( =) display (very roughly) the 
amount and area of memory occupied by each task or driver. 
Where the display shows only one delimiter ( <, !, +, [, (, 
etc.), the opening delimiter should be considered to appear 
in the same position as the closing delimiter of the 
preceding task. 


Loadable drivers loaded in memory, identified by device 
mnemonic. Although drivers are not tasks, they require 
memory, and thus are displayed with tasks. 


Partitions in the system. Partition name comes first, 
followed by a letter identifying the partition type. 
(Partition size is indicated in next entry.) The letters are 
defined as follows: 


task partition 

subpartition 

system-controlled (dynamic) partition 
common partition 


aunegd 


Partition size and location. The beginning of each partition 
is marked by a letter in the same code as above, with the 
following additions: 


E 
P 


Executive 
Pool (dynamic storage region) 


The lines of asterisks ( * ) represent (very roughly) the 
proportional amount and area of memory occupied by each 
partition. 


The system error count sequence as recorded by the error 
logger. If error logging is not included in the system, 
ERRSEQ will always equal zero. 


B.5 DISPLAY CONFIGURATION OPTIONS 


Certain parameters can be altered by the user who wants to develop 
special versions of RMDEMO. The source file, located in UFD[14,10] on 
your distribution kit, contains extensive comments that should enable 


you to 
display, 
that can 
- the 
- the 


Type ESC 


alter the code to move or delete fields in the existing 
or design additional display pages. These are two parameters 
be changed on-line, from a running RMDEMO display: 

display rate (interval at which information is updated) 

names of the FILES-11 devices in the free-space display area. 


(ALT MODE or SEL) to display the command formats for changing 


these parameters. 


APPENDIX C 


CONSOLE DRIVER AND CONSOLE OUTPUT TASK 


Two facilities in RSX-11M -- the Console Driver and the Console Output 
Task (COT) -- handle messages sent to the console device (CO:). COT 
is a privileged task usually installed and maintained by the System 
Manager. You can use COT to direct messages to: 


e The default console output device (usually TTO:) 


e Any other terminal that you assign as the console device with 
the COT SET commands 


e A console message logging file 


COT SET commands allow you to assign the destination of the messages 
to alternate devices or to terminate messages to the console device or 
logging device. The Console Driver sends all messages to COT, which 
forwards them to the terminal or logging device that you have 
selected. 


COT permits you to specify any terminal as a console terminal and _ to 
change that specification, using privileged MCR SET commands. You are 
not restricted to using TTO0: as the console terminal. You can also 
change the name of the file to which COT writes. (Any part of the 
command file specification can be changed independently.) If coT is 
aborted or the system crashes, you can recover the information in the 
log file by using the Peripheral Interchange Program (PIP) to unlock 
the file. You can then print its contents. (PIP is described in the 
RSX-11 Utilities Manual.) 


The Console Driver and COT are supported on mapped RSX-11M_ systems. 
They are not supported on RSX-11S systems, because RSX-11S does not 
Support the disk volumes you need to use the Console Driver's 
write-to-a-file feature. 


C.1 OPERATING COT 


The COT commands control the selection and operation of the console 
terminal or the log file either separately or together. You can 
start, control, and terminate console, log file, or COT operation by 
using one of the following privileged MCR SET commands: 


>SET /COTERM[=ttn:] 

>SET /NOCOTERM 

>SET /LOGFILE[=ddnn:] [uic] [filename. filetype] 
>SET /NOLOGFILE 

>SET /COLOG [=TTn:] [ddnn:] [uic] [filename. filetype] 
>SET /NOCOLOG 
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NOTE 


The brackets indicate optional entries. 
However, brackets must be entered when 
specifying the UIC, as [UIC] 


Once COT is running, COT processes all messages directed to CO: (ina 
QIO operation, for example). COT gets the time, prints the message 
and time on the console terminal, and writes the information in a 
file. The default terminal is TTO: and the default file is 
SY0:[1,4]CONSOLE.LOG, unless you specify another terminal or file. 


COT also uses the MCR SET commands to change or stop output to a 
terminal or file. You can change any COT option without stopping and 
restarting the entire task. 


C.1.1 Task Interfacing with COT 


Task interfacing with COT deals with the task's attempts to send 
messages, attach to, or read from the console terminal. 


Tasks can write messages to CO:. The buffer in COT accepts messages 
up to 256(10) bytes long. Therefore, any task sending longer messages 
must include carriage-returns/line-feeds in the text. Setting the 
buffer size to something other than 256(10) bytes can cause 
unpredictable results. 


When you have a task that must send a message to the console terminal, 
start the message with a CTRL/G. This message prints on the terminal 
regardless of the effect of a previously entered SET /NOCOTERM 
command. The CTRL/G causes COT to send the message to TTO: if no 
terminal is currently designated as the console terminal. The message 
goes to the current console terminal if one is designated. 


A task may not attach to CO:. If a task attempts to attach to CO:, an 
invalid function code error occurs. 


Only a task with the name COT... may read from CO:. If another task 
attempts to read from CO:, an invalid function code error occurs. 


C.1.2 Using the REDIRECT Command with COT 


When COT is not running, the system data structure (UCB) for CO: is 
directed to TTO:. Messages directed to CO: therefore go to the 
terminal driver (TTDRV) and then to TTO:. When COT starts, however, 
it directs CO: to CO: by adjusting the redirect pointer in the data 
structure. COT then receives messages directed to CO: and sends them 
to CODRV, which is the driver for console output. Therefore, to 
change the console terminal while COT is running, use the SET /COTERM 
command. When you use this command, COT changes the console terminal 
by issuing an Assign LUN Executive directive. If you use the REDIRECT 
command to affect the console terminal assignment while COT is 
running, device assignment problems or a system loop may occur aS a 
result. 
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You may encounter two conditions when using the REDIRECT command to 
affect the console terminal assignment while COT is running. 


1. If you redirect CO: to another device, the device handler 
for the device at the end of the redirect chain receives the 
message meant for CO:. This means that you bypassed COT 
entirely. Therefore, messages do not go to CO: and they are 
not written on the logging device. 


The console driver (CODRV) must receive messages sent to CO: 
for COT to work properly. CODRV receives the messages only 
if CO: is directed to CO:. 

2. You can use SET /COTERM to specify a different terminal for 
output. If you do this, do not use REDIRECT to redirect that 


terminal back to CO:. Using REDIRECT in this way causes a 
system loop that prevents any other processing on the system. 


C.2 COMMAND DESCRIPTIONS 
COT commands fall into three categories: 

1. Commands that control the console 

2. Commands that control the log file 

3. Commands that control both the console and the log file 
In the commands in which you specify all the options, the options must 
be specified in the order shown. Left and right brackets indicate 
that the enclosed specification is optional. However, brackets must 
be entered when specifying the UIC as [UIC]. 
In the commands that have optional file specifications 
(ddnn: [UIC] filename. filetype), the default file specification is 


SY0:[1,4]CONSOLE.LOG. Leaving out the device causes SY0: to be used 
and leaving out the filename.filetype causes CONSOLE.LOG to be used. 


C.2.1 Commands that Control the Console 


The following commands either start (or stop) COT or assign the 
console terminal. 


>SET /COTERM[=TTn:] 
>SET /NOCOTERM 
Description 
>SET /COTERM 


If COT is running, this command (without the TTn: option) 
assigns the default (TTO:) as the console terminal. 


If COT is not running, this command starts COT and assigns’ the 
default (TTO:) as the console terminal without a log file. 
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Option 
TTn: 
Specifies the terminal to be assigned as the console terminal. 


If COT is running, using the command with this option reassigns 
the console terminal. 


If COT is not running, the command starts COT and assigns the 
specified TTn: as the console terminal without a log file. 


In either case, you cannot designate a log file with this 
command. 


Description 
>SET /NOCOTERM 
This command terminates the output of messages to the console 


terminal. You can restart the logging of messages on the console 
terminal by using the appropriate SET command. 


C.2.2 Commands that Control the Log File 


The following commands control both the log file and the device on 
which it is written. 


>SET /LOGFILE[=ddnn:] [[UIC]] [filename. filetype] 


>SET /NOLOGFILE 


Description 

>SET /LOGFILE[=ddnn:] (The default is SY:) 
If cOT is running, this command terminates output to the current 
log file and opens a new log file on the specified device. The 
new log file is one version higher than the version of _ the 
current file. 
If COT is not running, this command starts COT with the default 
log file (if you do not use a file specification) on the 
specified device. This command does not assign a_ console 
terminal. 


The device-unit specification is ddnn:. 


Options 
{uic] 


Specifies the UIC to which the log file is written. The brackets 
must be used. 
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filename.filetype 
Specifies the file name and file type of the new log file. 
If coT is running, the command with this option specified 
terminates the current log file and opens a new log file with the 
name and type you specify. 


If COT is not running, the command with this option specified 
starts COT with a log file of the specified name and type. 


No console terminal is assigned. 


Description 
>SET /NOLOGFILE 
This command terminates writing to the log file. It does not 


open a new log file. To start writing to a new log file, use the 
appropriate SET command. 


C.2.3 Commands that Control Both the Console and the Log File 


The following commands control both the console and the log file to 
which messages are sent. 


>SET /COLOG=[TTn:] [ddnn:] {[uic]] [filename. filetype] 


>SET /NOCOLOG 


Description 
SET /COLOG 


If COT is not running, this command (without options) starts COT 
using the defaults terminal, device, UIC, and file 
specifications. You can use the options to specify the terminal, 
device, UIC, and log file that you want to use. 


If coT is running, this command (without options) displays the 
names of the log file and console terminal. 


If you enter any options with this command, while COT is running, 
you will get an error message. 

Options 

TTns 


Specifies the console terminal. If you do not specify TTn:, CoT 
sets the console terminal to TTO:. 


If coT is not running, the command with only this option 
specified starts COT, assigned to TTn:. The ddnn:, UIC, and 
filename.filetype options take the default value if you do not 
specify them. 
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ddnn: 


Specifies the device to which COT writes the log file. Use this 
option to change the device. 


If COT is not running, using the command with only this option 
specified starts COT using the default file specification of 
[1,4] CONSOLE.LOG on the ddnn: that you specified. Because only 
this option is present, COLOG sends messages to TTO: 


[uic] 
Specifies the UIC to which COT writes the log file. If you do 
not specify a UIC with the device ddnn: or filename.filetype, 
COT uses the default value of [1,4]. The brackets must be used. 


filename. filetype 


Specifies the file name and file type for COT to use when writing 
messages to the log file. If you do not specify the file name 
and file type, COT uses the default file specification of 
CONSOLE.LOG. 

Description 

>SET /NOCOLOG 


This command terminates COT. Before COT exits, it redirects CO: 
to TTO:. However, if it cannot redirect CO: to TTO:, COT sets 
CO: offline and exits. 


C.3 CONSOLE OUTPUT TERMINAL ERROR MESSAGES 

The following section lists the error messages COT can return, along 
with their causes and user response, where possible. Messages appear 
at the last terminal that issued a COT command. 

COT -- CONSOLE TERMINAL ASSIGN ERROR 


Explanation: An error occurred when COT attempted to assign a 
new console terminal. The error may be the result of specifying 
an incorrect terminal unit number. 
User Action: Reenter the command with a new terminal number. 

COT -- UNABLE TO SPECIFY AST, COT EXITING 


Explanation: COT was unable to specify an AST for receiving SET 
commands from MCR. COT exits after displaying this message. 


User Action: The probable cause of this error is an attempt to 
run COT on a system that does not include AST support. 


COT -- FILE OPEN ERROR, FCS nnn 


Explanation: An error occurred when COT tried to open a _ log 
file. The FCS error code is nnn and is printed as part of the 
message. 


User Action: Correct the problem designated by the FCS error 
number and restart the log file. 


cot 


coT 


cot 


cot 


COT 


coT 


coT 
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-- FILE WRITE ERROR, FCS nnn 


Explanation: An error occurred when COT tried to write to an 
existing log file. The FCS error code is nnn and is printed as 
part of the message. 

User Action: Correct the problem designated by the FCS error 
number. If the problem caused output to the log file to be 
stopped, restart output to a log file with the appropriate SET 
command. 

-- NOT LOGGING ON A TERMINAL OR TO A FILE, COT EXITING 


Explanation: This message is displayed if a SET /NOCOTERM or SET 
/NOLOGFILE command causes all message handling to be turned off. 


User Actions Because COT exits after printing this message, 
restart COT with the appropriate SET command. 


-- UNABLE TO REDIRECT CO: TO TTO: 


Explanation: COT was unable to legally redirect CoO: to TTO: 
when exiting. COT sets CO: offline when this occurs. 


User Actions: None. 
-- CO READ ERROR 


Explanation: An error occurred when COT tried to read from CO:. 
This is an informational message only. 


User Action: None. 
-- SYNTAX ERROR 


Explanation: COT detected a syntax error when parsing a command 
line. 


User Action: Check the syntax and reenter the command. 
-- DRIVER NOT LOADED, COT EXITING 


Explanation: The console driver was not loaded. coT cannot 
operate properly and exits. 


User Action: If console driver support and loadable driver 
support were requested during system generation, the console 
driver must be loaded. COT can then be restarted with the 
appropriate SET command. 


-- MAX CONSECUTIVE READ ERRORS, COT EXITING 


Explanations An error occurred on 10 consecutive read operations 
when COT was trying to read from CO:. The probable cause is a 
system failure external to COT. COT exits after displaying this 
message. 


User Action: Determine the problem that caused the excessive 
read errors and correct it. Then restart COT. 


COT 


SET 


SET 


SET 


SET 


SET 


SET 
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-- MAX CONSECUTIVE WRITE ERRORS, DISABLING LOGFILE 

Explanation: An error occurred on five consecutive write 
operations to the log file. COT attempts to close the log file 
and disables logging to the log file. 


User Action: Determine the problem that caused the write errors 
and correct it. Then restart message logging to the log file. 


-- INVALID KEYWORD 

Explanation: MCR received an illegal SET command. 

User Action: Check the command syntax and retry the command. 
-- PRIVILEGED COMMAND 


Explanation: COT can only be run or changed from a_ privileged 
terminal. 


User Action: Log in with a privileged account and reenter the 
command. 


-- MORE COMMAND PARAMETERS THAN PERMITTED 


Explanation: More parameters are specified on the command line 
than are allowed for the command. 


User Action: Check the command parameter syntax and reissue the 
command. 


-- FILE. SPECIFICATION EITHER INVALID OR NOT SPECIFIED 


Explanation: An invalid RSX-11M file specification was found in 
the command file. 


User Action: Reissue the command with a valid file 
specification. 


-- DEVICE NOT IN SYSTEM 


Explanation: The device name specified in the command is not a 
part of the current system. 


User Action: Check the system device table and reissue the 
command with the correct device name. 


-- YOU DO NOT HAVE THE PRIVILEGE TO ISSUE THIS COMMAND 


Explanation: The command you issued can be executed only from a 
privileged terminal. 


User Action: Log on to a privileged account and reissue the 
command. 


“~ 
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THE QUEUE MANAGER 


This appendix is directed to the system manager or operator who is 
setting up and running the Queue Manager on an RSX-11M system. Except 
where noted, all commands described here are privileged. 


Most. large systems will include the Queue Manager for the convenience 
of multistream line printer spooling. If not, the Serial Despooler, 
PRT..., can be installed instead. Note that the Queue Manager 
includes QMGPRT, which installs as PRT..., to intercept output from 
the PIP /SP switch and other utilities and system tasks. See the 
RSX-11 Utilities Manual for more detail. This choice is made at 
SYSGEN. 


This chapter consists of a narrative introduction and review. of the 
process of setting up the Queue Manager, detailed descriptions of all 
commands to the Queue Manager, and a listing of an indirect command 
file to be included in the system STARTUP procedure as a reference 
example. 


D.1 NARRATIVE INTRODUCTION AND REVIEW 
Here is the procedure for bringing the Queue Manager into the system. 


This can be done interactively, but in most cases it is more 
convenient to include it in an indirect command file invoked as part 
of the system's STARTUP procedures. 


Note that this procedure must be adapted for each installation. The 
example is based on the procedure used for the RSX-11M development 
system. QUE setup commands allow considerable flexibility in setting 
up the Queue Manager system. Dynamic alteration of the Queue Manager 
is also permitted. 


l-Install the Queue Manager. It is found with the privileged 
utility tasks. 


INS QMG/PRI=70 
2-Install the output despooler task (print processor). 
INS LPP/PRI=70 


This task installs automatically as LPPO. You must install this task 
for each physical device under the direction of the Queue Manager. 
This task “owns" the output device and must have a name based on the 
name of the device. Thus, the output despooler for LPl: must be 
installed under the name LPP1l, using the TASK= option. There can _ be 
up to 15 output devices controlled by the Queue Manager. 
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3-Install PRT... 
INS QMGPRT 


This task installs automatically as PRT... and is the interface to 
PIP and other tasks that use PRINTS or .PRINT. The Queue Manager can 
then accept jobs from the PIP /SP switch. Although this task has the 
Same name as the Serial Despooler used on previous versions of RSX-11M 
(and available on V3.2), it is not the same task. It replaces this 
task.) 


4-Install the Print Command Line Interpreter and the Queue Command 
Line Interpreter. 


INS QMGCLI/TASK=...PRI 
INS QMGCLI/TASK=...QUE 


The same task parses both the PRI and QUE commands and therefore must 
be installed twice, once under each name. 


5-Start the Queue Manager. 
QUE /START:QMG 


This command starts the Queue Manager and initializes the default 
queue PRINT. It creates the queue file QUEUE.SYS on S¥:[1,7] if it is 
not there. The command also clears all assignments previously 
recorded. If the queue file was intact, all queues will still contain 
their jobs, but are not assigned to print processors. (Processors 
will have to be spooled again.) 


5-Spool the processor. 
QUE LP: /SPOOL/FLAG:1/FORM:0 


This command creates a queue LPQO (if it does not already exist) and 
starts the previously installed despool task LPPO. This task attaches 
device LPO: for despooling. Queue LPQO is assigned to despooler 
LPPO. Repeat this step for each output device under control of the 
Queue Manager. 


The /FORM switch establishes this attribute of the despooler. This 
means the despooler accepts jobs initiated by Print commands with the 
Same /FORM attribute given. Jobs with other /FORM attributes remain 
in the queue until a despooler with the proper /FORM attribute is 
available. 


The /FLAG switch sets the default number of flag pages that precede 
each job. If users specify /FLag in their Print commands, each file 
in the job will be preceded by this many file flag pages as well. 


6-Assign the default queue to processors. 


QUE LP: /ASSIGN:PRINT 


This command assigns the default queue PRINT to processor LPPO. 
Normally, only the PRINT queue has to be assigned. Device-specific 
queues are assigned to their device despoolers by /SPOOL. This 
assignment of device-specific queues is a default, however, and not a 
requirement. A device-specific queue must exist for every spooled 
device, but these queues also can be assigned to other devices. 
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You can assign a queue to more than one processor and you can assign 
more than one queue to a processor. You can assign a device-specific 
queue to another device if necessary. For example, if printer LPO: 
is temporarily unavailable, you could assign LPQO to LPl:. 


D.2 REFERENCE EXAMPLE 


Here is a listing of SY:{1,2]QMGSTART.CMD from the RSX-11M development 
system: 


INS DBO:QMG/PRI=70 

INS DSO:LPP/PRI=70 

INS DSO:QMGPRT 

INS DSO: QMGCLI/TASK=...PRI 

INS DSO: QMGCLI/TASK=...QUE 

QUE /START:QMG 

QUE LP: /SPOOL/FLAG:1/FORM: 0 
QUE LP: /ASSIGN:PRINT 


D.3 QUEUE MANAGER COMMAND DESCRIPTIONS 


Setting up the Queue Manager is controlled through a number of 
privileged functions applied to the QUE command. 


The format of the Queue Manager setup commands is: 
>QUE ddnn:/function[:option[s]] [/swl[s]] 
Where: 
ddnn: is the device name. 
/function is the function to be performed. 
soption is the option for that function [may be more than one]. 
/sw is the switch for that option 
These commands allow a privileged user to attach or detach devices for 


spooling, start and stop devices, assign the default queue to devices 
and start and stop the Queue Manager. 


D.3.1 STOP 
This function suspends a device or stops the Queue Manager. 
>QUE ddnn: /STOp[: option] 
EOF 
EOJ 
>QUE /STOp:QMG 
ddnn: 


The device name is required with all options except /STO:QMG. 
You cannot include a device when stopping the Queue Manager. 
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option 


If you do not enter an option (null option) the device stops 
immediately. This is a pause. 


EOF 
The device stops at the end of the current file. 

EOJ 
The device stops at the end of the current job. 

/STO:QMG 
The Queue Manager stops at the end of the current job. All 
assignments of queues to devices are broken (deassigned). All 
despooler tasks are detached from their devices. The Queue 
Manager exits. 

Examples: 


>QUE LPO:/STOP 
This example stops printing on LPO:. No jobs will be taken from 
queues assigned to the device, but jobs can still be added to 
queues. 


>QUE LP2:/STO:EOJ 


This example stops printing on LP2: at the end of the active 
job. 


>QUE /STOP: QMG 


This example stops the Queue Manager. QMG is marked for stop and 
the current jobs are allowed to finish. 


D.3.2 START 


This 


command starts printing on a previously stopped device or starts 
the Queue Manager after a STOP. This command counteracts STOP. 
>QUE ddnn:/STArt[:option] [/sw] 
NExt /FOrm:n 
TOP /FLag:n 
PAge:n 
BAck:n 


ddnn: 


FOrward:n 


>QUE /STArt:QMG 


A device name is required with all options except /STA:QMG. You 
cannot include a device when starting the Queue Manager. 


) 
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option 
Option and switch are mutually exclusive fields. Use one or the 
other, 
If you enter nothing (null option), the device starts printing 
from the point at which printing stopped. This, in effect, 
resumes printing after a pause. 

NExt 
Printing starts at the top of the next job. 

TOP 
Printing starts at the top of the current file. 

PAge:n 
Printing starts at page n of the current file. 

BAck:n 
Printing starts n pages back from the point at which it was 
stopped. 

FOrward:n 
Printing starts n pages forward from the point at which it was 
stopped. 

STA:QMG 
This option is entered without ddnn: as it starts the Queue 
Manager and initializes the default queue PRINT. It creates the 
file Sy:{1,7]QUEUE.SYS if it is not there. The command also 
clears all assignments previously recorded. If the queue file 
was intact, all queues still contain their jobs, but are not 
assigned to processors. (Processors will have to be spooled 
again.) 

/Sw 
The switch and option fields are mutually exclusive. Use one or 
the other. You can enter more than one switch, however. 

/POrmsn 
This switch resets the forms type of the despooler task from. the 
type set with SPOOL. 

/FLag:n 
This switch resets the default number of flag pages set with 
SPOOL. Print jobs have n job flag pages preceding the job. If 
users specify /FLA in their print command, each file in the job 
will also be preceded by n file flag pages in addition to the job 
flag pages. n can be 0, 1,2, or 3. 
If you are using special forms in your printer, you should set 


n=0 so that no flag pages are printed on your special forms. 


THE QUEUE MANAGER 


Examples: 
>QUE LPO:/STA 
Start LPO:; printing proceeds from where it was stopped. 
>QUE LP2:/START:NE 
Start printing with the next job queued to LP2:. 
>QUE LP:/STA/FO:11 . 
Start printing on LPO: with FORMS attribute reset to ll. 
Notes: 


Page-related options have no effect unless the user specified a 
LEngth:n quantity in the Print command. 


If restarting a processor to handle special forms types, you may 
want to set FL to 0 to avoid printing banner pages on your 
special forms. 


D.3.3 SPOOL 


This function attaches a device for despooling. The command starts a 
despool task, optionally creates a queue named after it, and assigns 
the queue to the despool task. 


>QUE ddnn:/SPool/sw 


SPOOL creates queue ddQn (if it -does not already exist) and 
starts the despool task ddPn which must be installed previously 
for device ddn. This attaches device ddnn: for despooling by 
the despool task ddPn open to jobs from queue ddQn. 


/sw 
More than one switch can be used with this function. 
/FOrmsn 
Sets the device despooler to accept jobs with forms type n. 
You can set a despooler to accept more than one forms type, but 
the forms definition nust be duplicated. 
n 


This number can be anything from 0 to 255. The default is 0. 


These numbers are to be specified by your users in their Print 
commands. 


If the right forms are not in an available printer, then their jobs 
will be waiting until the printer has been stopped, the proper forms 
put in place, and the printer restarted using the /FORMS: qualifier 
and the proper value for n in the START/ command. 


Forms differ by their length and width. Both values can be set in the 
forms table. 


> 
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Setting width is simply a matter of how many columns are needed to 
fill in the form. There are no standard widths for forms, but 80. 
and 132. are the most common. 


Setting length requires you to determine whether your forms are of a 
standard length. 


"Standard length" is any form length that can be set on your printing 
hardware. If the hardware can handle the form by setting a response 
to a form-feed character <FF>, then it is a standard length form, and 
the form-feed is a "real", i.e., hardware, form-feed. 


If the form length cannot be set on the hardware, then it is a 
non-standard length. In this case, the form-feed <FF> must be 
replaced by an appropriate number of line-feeds <LF>. This is called 
a “simulated", i.e., software, form~-feed. 


You should determine which forms are used on your system and assign 
each a number. This number points to a table of form definitions. 
The form definitions consist of a single 16-bit word. The length is 
the low-order byte and the width is the high-order byte. The high bit 
of the length byte is set when simulated forms (forms whose length 
cannot be set on your hardware) are needed. This form definition word 
can be changed by editing the Task Builder command file for the 
despooler’ task. You must add a global patch statement of the 
following form: 


TKB>GBLPAT=INIT: FRMTBL+k: value 


where k is the assigned form number multiplied by 2 (n*2) and value is 
the form definition word (value = width + <200*SIMFF> + <width*400>). 


The following table shows the forms requirements for a hypothetical 
installation. The form names describe different uses that special 
forms might be put to, but have no significance otherwise. 


FORM ASSIGNED n WIDTH LENGTH SIMFF 
Accordion 0 132 66 N 
Paychecks 1 40 10 N 
Invoices 2 80 66 N 
Stationery 3 80 66 N 
Moon Diary 4 22 43 Y 
Star Log 5 112 113 Y 


(As shipped, FORMS:0 is 66 lines long by 132 columns with real 
form-feeds. FORMS:1 is 1 line long by 132 columns with simulated 
form-feeds; FORMS:2 is 2 lines long by 132 columns with simulated 
form-feeds; and so on through FORMS:66 which is 66 lines long by 
132 columns with simulated form-feeds. The remaining FORMS:n 
entries are set to 1 line long by 132 columns with simulated 
form-feeds. Thus, if you specify FORMS:43, when the printer 
encounters a form feed, it counts the number of lines on the page 
and subtracts that number from 43. The printer then reels off a 
number of line feeds equal to the difference. You may find this 
arrangement satisfactory if your installation rarely uses forms 
other than standard line-printer paper, but if you have more than 
one standard form, you will probably want to make the changes in the 
forms table entries. ) 


/FLag:n 


Sets the number of flag pages to precede all jobs printed on the 
device. Note that if you are using special forms, you may want to 
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set this attribute to 0 to avoid printing banner pages on your 
special forms. This also sets the number of file flag pages to be 
printed when users specify the FLAGS switch in their Print commands. 
Examples: 

>QUE LPO:/SPOOL 

Attach LPO: for despooling. 

>QUE LP3:/SP/FO:2 


Attach LP3: for despooling with forms set to 2. 


D.3.4 UNSPOOL 
This function removes a device from despooling. The device no 
longer is assigned to queue. The despooler task exits. The 
associated device-specific queue is not deleted. 

>QUE ddnn:/UNSPool 
UNSPOOL frees a device used in despooling for general use. The 
despool task for the device exits but its entries in queues assigned 
to it remain in the queue file. 
Example: 

>QUE LPO:/UNSP 


This example removes the device LPO: from active use by the 
despooler LPPO and the Queue Manager. 


D.3.5 ASSIGN 
This function creates a path between a queue and a despooler. 
>QUE ddnn: /ASsign: queuename 


ASSIGN is normally used to assign the default queue PRINT to one or 
more despooler tasks, but you can assign any queue to any despooler. 


Example: 
>QUE LPO:/AS:PRINT 
Assign PRINT queue to LPO:. 
Notes: 
Remember that SPOOL automatically assigns a device-specific 


queue to its related device. For example, LPQ1 is 
automatically assigned to LPl:. 
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D.3.6 DEASSIGN 
This function breaks the assignment of a queue to a despooler. 
>QUE ddnn: /DEAssign: queuename 
DEASSIGN eliminates the path between a queue and a despooler, but 


the queue still exists with all its jobs. Jobs can be added to the 
queue, but none will be dequeued while the queue is not assigned. 


APPENDIX E 


THE RSX-11M 1/0 EXERCISER 


E.1 INTRODUCTION 


The RSX-11M I/O Exerciser (IOX) is a software tool that you can use to 
diagnose hardware and software I/O problems. I0X is intended for use 
by system managers, system operators, and system programmers who want 
to test units in a hardware configuration to determine whether these 
units are correctly executing I/0 operations. In addition, IOX allows 
you to measure system activity. 


IOX provides a command language for executing test functions. IOX 
output consists of detailed error reporting and general information 
describing system activity. 


You should be familiar with information in the following publications 
to effectively use IOX: 


e RSX-11M/M-PLUS Error Logging Reference Manual 


@ RSX-11M/M-PLUS MCR Operations Manual 
e RSX-11 Utilities Manual 


E.1.1 What IOX Does 


The I/O Exerciser (IOX) tests the I/O units in your configuration to 
ensure that they correctly execute I/O functions. 


IOX exercises I/O units on your system by writing a data pattern to a 
volume on a unit and reading the data that was written. I0X then 
checks to ensure that the pattern read matches the pattern written. A 
mismatch between the written pattern and the pattern being read 
indicates an error. IOX reports errors when they are encountered. 
IOxX also displays activity reports at specifed intervals and at the 
completion of an I/O exercise. 


IOX has a command language that you can use to direct I/O exercise 
functions. IOX provides commands to: 


e@ Set up units in a test configuration 
e Select specific units to be tested 


e Set I/O exercise execution conditions 
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e Control I/O exercise execution 


e Direct command lines to RSX-11M for execution during an 
exercise 


@ Measure system activity using the IOX idle loop 
Section E.2 summarizes, in alphabetical order, the I0OX commands. For 


complete command descriptions, including formats and usage rules see 
Section E.10. 


E.1.2 Setting Execution Conditions 


IOX execution-time parameters allow you to set conditions under which 
an I/O exercise executes. You set these parameters using commands to: 


e Specify the number of 1/0 errors I0X tolerates before 
deselecting a unit 


@ Set the length of time between interval summary reports 
e Direct summary reports to the log file I0X.LOG 


e Specify the size of the temporary file I0X uses when it 
exercises a unit containing a Files-li-formatted volume 


e Specify the size of the buffer I0X uses when it exercises 
units containing non-file-structured volumes 


For more information on how to use the IOX execution-time parameters, 
see Sections E.3.4 and E.5. 


E.1.3 Controlling the I/O Exercise 


IOX commands allow you to control execution of an I/O exercise. Using 
execution control commands you can: 


e Interrupt execution of an I/O exercise to enter IOX commands 
interactively 


e Abort execution of an I/O exercise or a task 
e Deselect units from the test configuration 


e Display current execution status, parameter settings, and 
summary information 


e Modify execution parameters 


@ Restart IOX 
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E.1.4 Devices Supported by IOX 


The following is a list of devices supported for IOX: 


Device Abbreviation 
RP04/RP05/RP06 DB: 
TUS8 DD: 
RF11l DF: 
RKO5/RKOSF DK: 
RLO1/RLO2 DL: 
RKO6/RKO7 DM: 
RPO 2/RPRO2/RPO03 DP: 
RM0 2/03 DR: 
RSO03/RS04 DS: 
RXO1 DX: 
RX02 DY: 
TU60 CT: 
TU56 DT: 
TU1L6/TE16/TU45/TU77 MM: 
TSO04 MS: 
TU1O/TE10/TS03 MT: 


E.2 ‘SUMMARY OF IOX COMMANDS 


Table E-1 is an alphabetical list of IOX commands with a summary of 


the functions each provides. 


Table E-1l 
Summary of IOX Commands 


Command Description 


ABORT Terminates execution of an I/0 exercise before 


normal completion 


Terminates execution of a task initiated by the 


EXECUTE command 


ABORT taskname 


ABORT /ALL Terminates execution of all tasks initiated by the 
EXECUTE command 
BADBLOCKS Enters the numbers of bad blocks in the I0OX bad 


block list; displays the blocks in the bad block 
list 


Sets the default size of the buffer IOX uses to 
write and read when exercising a unit with a 
non-file-structured volume 


BUFFERSIZE 


CONFIGURE Adds a unit to your test configuration; displays 
the units in your test configuration 
CONTROL C Enables or disables the interruption of an I0OX 


exercise to enter a command interactively 


(continued on next page) 


Command 
DENSITY 
DESELECT 
ERRORLIMIT 
EXECUTE 
EXIT 
FILES11 
HELP 


INTERLEAVE 


ITERATIONS 
LOGFILE 


PARAMETERLIST 


PATTERN 
PRINTSUMMARY 
PROCEED 
RANDOM 
REPORTERRORS 


RESTART 


RETRIES 


RUNTIME 
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Table E-1 (Cont.) 
Summary of IOX Commands 


Sets the tape density for magnetic tape testing; 
displays the current or default density and 
characteristics word 


Terminates testing on a unit 


Sets the number of errors tolerated before IOX 
deselects a unit 


Directs a command line to the operating system for 
execution 


Exits from IOX to the operating system monitor 


Selects a unit with a Files-11 volume mounted; 
directs IOX to protect the volume data structure 
during an I/O exercise 


Displays a summary description of IOX commands at 
your terminal 


Sets the block interleave factor for disk testing 


Sets the number of times through the IOX idle loop 
for the idle loop iteration count 


Directs activity reports and error reports to 
either your terminal or the log file IOX.LOG 


Displays the current settings for IOX parameters 


Sets the test pattern IOX writes and reads during 
testing; display all test patterns 


Displays 
terminal 


a summary report of IOX activity at your 


Resumes IOX test execution after it has been 
interrupted by CTRL/C in interactive mode 


Enables or disables testing of random blocks 
rather than sequential blocks during testing 


Enables or disables error reports directed to your 
terminal 


Reinitializes IOx: stops testing, deconfigures 
all units except default units, deselects all 
units, and resets all parameters to their default 
values 


Enables or disables retries of I/0 by 


I/O drivers detecting I/O errors 


operations 


Sets the length of time IOX is to test units 


(continued on next page) 
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Table E-1 (Cont.) 
Summary of IOX Commands 


Command Description 
SELECT _ Selects a-unit with a non-file-structured volume 


for an I/O exercise 


SPY Displays execution-time information for a specific 
unit or for all selected units 


START Begins an I/0 exercise on selected units in your 
configuration 


SUMMARY TIME Sets the time interval between interval summary 
reports 


TEMPORARY FILE Sets the size of the temporary file IOX uses to 
exercise units with Files-1l volumes mounted 


VERIFY Ensures that data can be read from a unit 


VOLUMECHECK Checks to determine whether a unit to be tested 
has a Files-11 volume mounted 


WAIT Specifies the algorithm IOX executes in its idle 
loop 


WRI TECHECK Enables or disables write checks to disks 


E.3 INSTALLING, INVOKING, AND RUNNING IOX IN AN EXERCISE EXAMPLE 
This section uses an example of a terminal session to show you how to 
install and invoke I0OX, set up your test configuration, set up 


execution-time parameters, select units you want to exercise, and 
start the I/O exercise on those units. 


E.3-l1 Installing IOx 


If IOX is not installed on your system, install IOX by using the MCR 
INSTALL command: 


>INS $IOX/INC=nn 
where: 
nn is 1.2K words per device to be tested. 


If your Executive was built with the Extend Task directive included in 
it, you need not specify the INC keyword. 


The Task Builder command file for IOX built IOX as a _ nonprivileged 
task that is checkpointable and that runs at a priority of 50(10) in 
the GEN partition. 
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E.3.2 Invoking IOx 


If IOX is installed on your system, invoke it with the command: 


>IOX 


IOX responds by prompting you with the task name assigned by the 
operating system: 


ITOX> 
When you receive this prompt, you can enter IOX commands. 


If I0X is not installed on your system, you can invoke it with the MCR 
RUN command: 


>RUN $IOX/INC=nn 
where: 
nn is 1.2K bytes per device to be tested. 


If your Executive was built with the Extend Task directive included in 
it, you need not specify the INC keyword. 


In this case, IOX names the task using your terminal number and 
prompts you using this task name. For example: 


TT36> 


When you receive this prompt you can enter IOX commands. 


E.3.3 Setting Up Your Test Configuration 


All units have unit number 0 included in the IOX test configuration by 
default. You must explicitly configure any other units you want to 
exercise. For example: 


IOX>CONFIGURE DK1: 
IOX>CONFIGURE DK2: 
IOX>CONFIGURE MM5: 


E.3.4 Setting Up Execution-Time Parameters 


You can set conditions that affect the execution of the I/O exercise. 
For example, you can specify the length of exercise execution time, 
how often you want a report of exerciser activity, and whether you 
want the activity reports directed to the log file SY0:IOX.LOG. You 
can also request IOX to determine whether the units being tested have 
Files-11 volumes mounted. 


The following commands are an example of how to set up execution-time 
parameters for an I/O exercise: 


IOX>RUNTIME 10 
IOX>SUMMARYTIME 4 
IOX>LOGFILE YES 


These commands direct IOX to execute the I/O exercise for 10 minutes, 


generate an interval report every four minutes, and direct all reports 
to the log file. 
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E.3.5 Selecting Units for an 1/0 Exercise 


Once you have set up your test configuration, you can select units to 


be tested. Only units you explicitly select are exercised For 
example: 


IOX>FILES11 DK1: 


This command selects unit DK1: for exercising. When IOX executes, 
only DKl: is exercised. You can use either the SELECT command or the 
FILES11 command to select a unit for exercising. The FILES11 command 
is used in this example because it protects the file structure on a 
Files-11 volume during an I/O exercise. 


E.3.6 Starting an IOX Exercise Execution 


After setting up your configuration and selecting the units you want 
exercised, begin the I/O exercise by entering the START command: 


ITOX>START 


IoxX then performs pattern checking on DK1: for the length of time you 
specified with the RUNTIME command (10 minutes). ‘When IOX completes 
execution, it generates a summary report and the interval reports, and 
directs them to the log file IOX.LOG. You can gain access to and 
examine the log file after you exit from IOX by entering the command: 


>PIP TI:=I10X.LOG 


This command directs the PIP utility to display the file at your 
terminal. 


E.3.7 Exiting from IOx 


You can exit from IOX and return control to the operating system 
monitor by using the EXIT command: 


IOX>EXIT 


E.4 IOX OPERATIONAL MODES 


IOX operates in three modes: command, execution, and interactive. 
Operational modes are controlled by means of CTRL/C and carriage 
return on your terminal keyboard. 


In most cases, CTRL/C causes RSX-11M to interrupt a task and give 
control to MCR, the keyboard monitor. You then receive the MCR prompt 
(>) at your terminal. 


However, by entering the CONTROL _C command, IOX allows you to use 
CTRL/C in an alternate way: you can use CTRL/C to interrupt an IOX 
I/O exercise and give control to IOX rather than to MCR. 


This section describes the operational modes and how to use the I0xX 
CONTROL _C command to control them. 
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E.4.1 Command Mode 


When you invoke IOX by entering the command line described in Section 
E.3.2, "Invoking IOX," IOX is in command mode waiting for you to enter 
a command. When you press carriage return in command mode, I0X 
prompts you: 


TOX> 


When you enter CTRL/C in command mode, RSX-11M issues the MCR prompt 
and the normal rules for entering commands to MCR apply. 


In command mode, you can use the CONTROL_C command to enable or 
disable interruptions to an I/O exercise. CONTROL C YES enables 
interruptions, allowing you to enter commands Interactively; 
CONTROL C NO disables interruptions to an I/O exercise. 


E.4.2 Execution Mode 


When you begin an I/O exercise (by means of the START command), I0X 
enters execution mode. 


If you have enabled interruptions to the I/O exercise by means of 
CONTROL _C YES, IOX will not accept any input from your terminal except 
CTRL/C. If you try to enter any other input, IOX responds with the 
message: 


IOX -- ONLY *C ALLOWED 


If you have disabled interruptions to the I/O exercise by means of 
CONTROL _C NO, CTRL/C causes RSX-11M to issue the MCR prompt and 
execution of the I/O exercise continues. In this case, execution of 
the I/O exercise cannot be interrupted. 


E.4.3 Interactive Mode 


When CONTROL _C YES is set, you can interrupt an I/O exercise to enter 
commands interactively. When you enter CTRL/C, IOX prompts you: 


IOx> 


When you receive this prompt, you can enter any IOX command except the 
following: 


BUFFERSIZE 

PATTERN (PATTERN with no arguments is permitted) 
RUNTIME 

RESTART 

START 


These five commands must be entered in command mode. 


CTRL/C places IOX in interactive mode until you enter PROCEED. In 
interactive mode, the I/0 exercise continues to execute, but error 
reports and activity reports directed to your terminal (if LOGFILE NO 
is set) are suspended until you enter PROCEED. If you set LOGFILE 
YES, error reports and activity reports are generated normally. 


C 
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CTRL/C halts the I0X clock so that even though the I/0 exercise is 
continuing, it is not being timed by the IOX clock. Consequently, the 
exercise may run longer than you specify in the RUNTIME command. 


E.5 SETTING EXECUTION-TIME PARAMETERS 


Many IOX commands set IOX execution-time conditions, such as how long 
IOX executes, time between summary reports, and so _ forth. The 
PARAMETERLIST command displays all execution-time parameters and _ the 
value of their current setting. For example: 


IOX>PARAMETERLIST 

BUFFERSIZE= 1024. CONTROL_C=YES 
ERRORLIMIT= 10. LOGFILE= NO 
INTERLEAVE= 4. RANDOM= YES 
ITERATIONS= 10. REPORTERRORS= YES 
PATTERN= 4. RETRIES= NO 
RUNTIME= 5. VOLUMECHECK= YES 
SUMMARYTIME= 1. WAIT= YES 
TEMPORARYFILE= 500. WRITECHECK= NO 


DYNAMIC MEMORY USAGE= 3278.:2248.:2248.:1. 


There are five categories of execution-time parameters. These 
parameters are controlled by commands that: 


e Set general execution-time conditions 
® Set execution-time conditions for units with Files-11 volumes 


e Set execution-time conditions for units with 
non-file-structured volumes 


e Set execution-time conditions for measuring system activity 


e Direct the operating system to execute non-IOX tasks 


The following sections describe the commands in each of these 
categories. 


E.5.1 Setting General Execution-Time Conditions 


General execution-time commands affect the execution of all I/0 
exercises. You are likely to want to set these commands each time you 
run IOX; therefore, you may want to put them in an indirect file. 


LOGFILE Allows you to direct IOX activity reports to a log 
file, IOX.LOG 

RUNTIME Allows you to set the length of time an I/0 exercise 
is to execute 

SUMMARYTIME Sets the time interval between interval summary 
reports 

ERRORLIMIT Sets the number of I/0 errors IOX tolerates before it 


deselects a unit from the test configuration 


REPORTERRORS Enables or disables error reporting 
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CONTROL_C Enables or disables interruptions to an I/O exercise 


PATTERN Sets the test pattern IOX writes and reads when 
exercising a unit 


E.5.2 Setting Execution Conditions for Units with Files-11 Volumes 


To set execution conditions for units with Files-1l1l volumes. Use the 
FILES-11 and TEMPORARYFILE commands. The FILES11 command selects a 
unit to be exercised; the TEMPORARYFILE command specifies the default 
size of temporary file IOX uses when it exercises the unit. You can 
override this default with the FILES11 command. 


Files-1l1 volumes are volumes formatted for use by the RSX-11M file 
system, Files-ll. These volumes have data structures such as home 
blocks, directories, and boot blocks on them. The FILES11 command 
selects a unit with a Files-11 volume and allows you to exercise the 
unit without destroying the data structures or files on the volume. 


IOX uses a temporary file when it exercises a unit with a Files-1l 
volume. IOX creates the temporary file on the volume to be tested and 
marks the file for deletion. I0X then selects a random block in the 
temporary file to exercise. Because the temporary file is marked for 
deletion, it is erased from the disk's file structure when’ the 
exercise completes or IOX terminates. 


E.5.3 Setting Execution Conditions for Non-File-Structured Volumes 


To exercise units with non-file-structured volumes, use the SELECT 
command. The SELECT command does not check for any of the Files-1l 
data structures; it exercises the entire volume, destroying all data 
on the volume. 


Use the VOLUMECHECK command (VOLUMECHECK YES) to ensure that the 
volume on the unit you select does not contain any Files-11l data 
structures. VOLUMECHECK directs IOX to warn you if it finds such 
structures on what you think is a non-file-structured volume. 


You may set four execution conditions when you exercise units with 
nonfile-structured volumes: the default buffer size, the pattern 
checking method, the bad block locations, and whether IOX performs 
certain I/O operations during the exercise. 


E.5.3.1 Setting the Default Buffer Size - Use the BUFFERSIZE command | 


to change the default size for the buffer IOX uses when it does 
pattern checking. When you invoke IOX, the default buffer size is 
1024. You can override any default you set when you enter SELECT with 
another buffer size. 


E.5.3.2 Choosing a Pattern-Checking Method - IOX can exercise a unit 
by writing to and reading from either random blocks or sequential 
blocks on a volume. You can control the pattern-checking method with 
the RANDOM and INTERLEAVE commands. 


If you specify RANDOM YES, IOX exercises randomly selected blocks. on 
the volume. 
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If you specify RANDOM NO, IOX exercises sequential blocks on _ the 
volume, beginning with block 0. IOX adds the interleave factor to the 
location of the last block exercised and uses the result of the 
addition to determine the next block to exercise. For example: 


RANDOM NO 
INTERLEAVE 1000. 


These commands direct IOX to begin at block 0 and perform pattern 
checks on blocks 0, 1000, 2000, and 3000. 


E.5.3.3 Entering Bad Block Locations - Use the BAD BLOCKS command to 
enter the locations of known bad blocks (that is, bad blocks located 
by the RSX-11M BAD utility) on a volume. I0OX maintains a list of bad 
blocks and ignores them during an 1/0 exercise. I0X allows you to 
enter the locations of bad blocks manually; you must know where such 
blocks are on the disk to use this command effectively. See the 
description of the BAD BLOCKS command in Section E.10 for information 
on how to enter the locations of bad blocks. 


E.5.3.4 Controlling 1/0 Operations During the 1/0 Exercise - Use the 
RETRIES and WRITECHECK commands to disable certain 1/0 operations 
during an I/O exercise. RETRIES NO directs an I/O driver to not retry 
an I/O operation when it receives an error. WRITECHECK NO directs an 
I/O driver to not perform write checks on WRITE I/O operations, 


E.5.4 Setting Execution Conditions for Measuring System Activity 


IOX provides two commands for measuring system activity: WAIT and 
ITERATIONS. 


IOX executes an idle loop while it waits for units to complete 1/0 
operations. It can execute either one of the following in this loop: 


1. The wait-for-event-flag algorithm 
2. The instruction 
BICB -—(SP),(SP)+ 


The BICB instruction takes a large amount of CPU time and can be used 
to measure I/O throughout. 


The wait-for-event-flag algorithm is the default, but you can disable 
it and execute the BICB instruction by entering the command: 


WAIT NO 


You can determine the exact execution speed of the BICB instruction on 
your processor by referring to the appropriate PDP-1l Processor 
Handbook. Using this information, along with the number of times I0OX 
executes the instruction, as set by the ITERATIONS command, you can 
estimate the level of system I/O throughput. 


See the ITERATIONS command description in Section E.10. 


E.5.4.1 The IOX Idle Loop Algorithm - The following code is 


for 
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provided 


to measure the instruction times in the IOX idle loop. This 
listing is the actual code in the IOxX idle loop. 


BCKGND: : TST STOPFG ;TIME FOR INTERVAL REPORT? 
BMI 308 ;IF MI YES 
1s: TST ASTCFG ;STAY IN INTERACTIVE MODE? 
BEQ 5$ 7;IF EQ NO 
CLR ASTCFG 7YES, ASSUME WE WILL LEAVE IT 
CALL SDEQUE ;DEQUEUE ALL PENDING DESELECTS 
CALL CMDAST ;CALL INTERACTIVE COMMAND INTERPRETER 
BR BCKGND ; LOOP AGAIN 
58: TST RUNFLG ;ARE WE RUNNING? 
BMI 40s 7;IF MI NO, ABORT 
10$: MOV SITCNT,CNTI ;SETUP ITERATION COUNT 
158: CALL SDEQUE 7DEQUEUE ANY PENDING DESELECTS 
TST SWAIT ;USE "WTSESS" INSTRUCTION? 
BEQ 20$ ;IF EQ NO 
WTSESS #WAIEFN 7;WAIT FOR IOX TO DO SOMETHING 
.EFSS #WAIEFN ;NOW CLEAR THE EVENT FLAG 
iT STOPFG 7TIME FOR INTERVAL REPORT? 
BMI 30$ ;IF MI YES 
TST TTACTV 7°C ACTIVE? 
BNE 1$ ;IF NE YES 
BR 255 7GO COUNT ITERATIONS 
20S: BICB -(SP),(SP)+ ;WAIT 
258: DEC CNTI ;ALL FINISHED? 
BGT 158 ;IF GT NO 
ADD #1,CNTA ;UPDATE IDLE LOOP COUNT 
ADC CNTB ;RIPPLE CARRY 
ADC CNTC 
BR BCKGND ; LOOP AGAIN 
E.5.5 Directing the Operating System to Execute Non-IOX Tasks 


Use the EXECUTE command to direct commands to the operating system for 
execution. These tasks execute concurrently with an I/O exercise. 
For example: 


EXECUTE ...BAD DK1:/LI 


This command specifies that you want the operating system to 
the BAD utility. 


execute 


You can use the PARAMETERLIST command to display the status of tasks 
you initiate using EXECUTE. See Section E.7, "Displaying I/O Status 
Information," for details on these status reports. You can use the 
ABORT command to terminate one (ABORT taskname) or all (ABORT /ALL) 
tasks initiated by EXECUTE. 


E.6 I/O EXERCISE OUTPUT 


IOX generates two types of output: activity reports and 
reports. Activity reports are summaries of I0OX 
information, such as how long an I/O exercise has run and how much 
time remains for the I/O exercise to complete. Error reports show 
such information as the block where an I/O error was encountered. 


error 
processing 
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E.6.1 Activity Reports 
There are three types of activity reports: 


e Summary report -- an activity report summarizing IOX activity 
for the entire I/O exercise 


e Interval report -- an activity report summarizing IOX activity 
in the time intervals set by the SUMMARYTIME command 


e Print summary -- a report displayed at your terminal 
summarizing the IOX activity in the interval between the last 
summary report and the time you entered the PRINTSUMMARY 
command. 


Using the LOGFILE command, you can direct I0X to display summary 
reports, interval reports, and error reports at your terminal or you 
can direct them to the log file IOX.LOG. The following lines show the 
general format of IOX activity reports. 


18-SEP-78 15:44:42 #*eekAEA EXERCISER STARTED *****4x% 
TIME -- RUN: 1 MIN. ELAPSED: 1 MIN. REMAINING: 0 MIN. 
DKO: -- 1,183. REQUESTS TOTALING 1,183. BLOCKS WITH NO ERRORS 
IDLE-LOOP COUNT: 724. ITERATIONS 


18-SEP-78 15:45:56 ****eee*e EXERCISER TERMINATED ***444x% 


As shown above, the output of activity reports consists of lines 
telling when exerciser events occured and lines containing status 
information. : 


The exerciser event lines tell you when the exerciser began execution, 
terminated execution, aborted execution, started a log file, and 
terminated entries to the log file. The following line is an example 
of a line describing an exerciser event: 


18-SEP-78 15:45:56 *****4*k* EXERCISER STARTED ******%% 
There are five types of status information lines: 
e General user information: date and time of report 


e Timing information: time between reports, total execution 
time (to the nearest minute), and remaining execution time 


e Unit information: number of I/O requests to the unit, number 
of blocks exercised, and number of errors encountered on the 
unit 


e Idle loop information: number of iterations through the idle 
loop 


e Error reports: see Section E.6.2 


Both summary reports and interval reports can be directed to either 
your terminal or the log file by means of the LOGFILE command. 
LOGFILE YES specifies that the summary information is directed to the 
log file; LOGFILE NO specifies that the summary information is 
displayed at your terminal. LOGFILE NO is the default. 


To generate a print summary, use the PRINTSUMMARY command. This 
report cannot be directed to the log file. The print summary shows 
the amount of IOX exercise activity in the interval between the last 
interval report and the time you entered the PRINTSUMMARY command. 
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E.6.2 Error Reports 


The following lines show the form of an IOX error report. At the same 
time IOX is reporting this information, if error logging is enabled, 
.the RSX-11M error logging program is also logging the error. For 
information on how the error logger handles the errors, refer to the 


RSX-11M/M-PLUS Error Logging Reference Manual. 


DK1: -- UNRECOVERABLE ERROR AT BLOCK 358 (DECIMAL) 546 (OCTAL) 
DK1: -- DATA ERROR AT BLOCK 358 (DECIMAL) 546 (OCTAL) 
GOOD DATA: 165555 BAD DATA: 167155 (OCTAL) 
WORD POSITION: 308 (DECIMAL) 464 (OCTAL) 
The error report comprises up to three lines. The first line tells 
you the block number (in decimal and octal) where the error was 
encountered. The second line tells "good data" and "bad data." The 
third line indicates the position of the word within the block (in 


decimal and octal) where the error was encountered. Only the first 
error encountered in the block is reported. 


E.7 DISPLAYING IOX STATUS INFORMATION 

IOX provides four commands for displaying status information: 
@e PARAMETERLIST - displays parameter settings 
e SPY - displays the status of a unit being tested 
e CONFIGURE - displays all devices in your configuration 


e PATTERN - displays all 11 IOX patterns 


E.7.1 Displaying Parameter Settings 


The PARAMETERLIST command displays the settings of IOX exercise 
parameters at the time you enter the command. The following lines 
show format of a PARAMETERLIST display. 


TASK STATUS COMMAND LINE 

«+eBAD QUEUED DKO:/LI 

DEVICE LUN BUFSIZE TYPE FILESIZE 
DB1: 5. 512. Fll 500. 
DB2: 6. 512. Fll 500. 
MM1: 7. 1024, NFS 

BUFFERSIZE= 1024. CONTROL C= YES 

ERRORLIMIT= 10. LOGFILE= NO 

INTERLEAVE= 4. RANDOM= YES 

ITERATIONS= 10. REPORTERRORS= YES 

PATTERN= 4. RETRIES= NO 

RUNTIME= 5. VOLUMECHECK= YES 

SUMMARYTIME= 1. WAIT= YES 

TEMPORARYFILE= 500. WRITECHECK= NO 


DYNAMIC MEMORY USAGE= 3278.:2248.:2248.:1. 
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For tasks initiated by the EXECUTE command, the PARAMETERLIST command 
displays: 
e The installed task name (...BAD) 


e The execution status (QUEUED, ACTIVE, SUCCESS, WARNING, ERROR, 
SV ERROR) 


e The command line elements you entered (DK0O:/LI) 
ACTIVE indicates that IOX is being executed. The remaining status 
indications relate to the Exit with Status (EXSTS) Executive 
directive. For more information on these status indications, refer to 
the RSX-11M/M-PLUS Executive Reference Manual. 
For selected units, PARAMETERLIST displays the following information: 

e Device specifications (DBl:, DB2:, and MM1:) 

e Logical Unit Number (LUN) (5, 6, and 7) 

e Buffer size IOX uses for reads and writes (512(10) for units 

with Files-1ll volumes; 1024(10) for units with 


non-file-structured volumes) 


@e Type of volume mounted on unit (Fll for Files-1l; NFS for 
non-file-structured volumes; VFY for units being verified) 


e File size of the temporary file IOX uses for processing units 
with Files-1l volumes mounted 


The line describing dynamic memory usage is in the form: 
totalmemory: freeblock:freebytes: fragments 


totalmemory 
Indicates the size of IOX dynamic memory in bytes, 


freeblock 
Indicates the size of the largest free block of I0OX dynamic 
memory in bytes. 


bytes 
Indicates total free bytes available in IOX dynamic memory. 


fragments 
Indicates the number of memory fragments in IOX dynamic memory. 


E.7,.2 Displaying Unit Status 
The SPY command displays the status of the unit or units you are 
exercising. The following line is an example of a SPY command display 
line: 

DBO: -- TYPE=F1ll VBN=305. I/0O=AST QUEUED FUNCTION=WRITE 
This line indicates: 


e The unit being exercised (DBO:) 


e The current virtual block being exercised (305(10)) 
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e The type of volume mounted on the unit (Files-11l) 
e I/0 request status: AST QUEUED, IN PROGRESS, or IDLE 


e The type of I/O function being performed (write) 


E.7.3 Displaying the Units in Your Configuration 


The CONFIGURE command displays all devices that are part of your 
system's configuration. 


For example: 
IOX>CONFIGURE 
This command produces the following display: 


DBO DDO DFO DKO DLO DMO DPO DRO DSO Dx0 
DYO CTO DTO MFO MMO MSO MTO 


E.7.4 Displaying the Pattern Setting 


The PATTERN command displays all 11 possible patterns that IOX writes 
and reads during testing. 


For example: 
IOX>PATTERN 
This command produces the following display: 


000000,000000 
177777,177777 
125252,052525 
165555,133333* 
163126,163126 
055555,155555 
022222,122222 
111111,111111 
007417,007417 
021042,021042 
104210,104210 


FPOWDINAHAUNBWNE 


re 


The asterisk indicates the default pattern that the system builds into 
IOX, 


E.8 STARTING AND CONTROLLING IOX EXECUTION 


The START command begins execution of an I/O exercise on units 
selected by the FILES11 command and the SELECT command. Section E.3.6 
describes how to use the START command. 


The CONTROL_C command enables or disables the use of CTRL/C to 
interrupt ‘an 1/0 exercise (see Section E.4). CONTROL_C YES enables 
interruptions to an I/O exercise; CONTROL _C NO disables interruptions 
to an I/O exercise. 
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E.8.1 Disabling Interruptions to an I/O Exercise 

When you set CONTROL C NO the I/0 exercise cannot be interrupted. 
That is, when you enter CTRL/C, MCR prompts you and the rules for 
entering commands to MCR apply. The only way to terminate the I/0 
exercise in this case is to use the MCR ABORT command: 


>ABORT IOX 


E.8.2 Interrupting IOX to Enter Commands 

When you set CONTROL C YES, you can interrupt IOX to enter commands 
interactively by entering CTRL/C on your keyboard. For example, you 
can execute other tasks with the EXECUTE command or abort the I/O 
exercise with the IOX ABORT command. During this interactive session, 
however, IOX suspends display of error reports and activity reports to 
your terminal. 

PROCEED directs IOX to resume displays of error reports and activity 
reports at your terminal. When IOX is in interactive mode, these 


reports are discontinued even though the exercise continues’ to 
execute. 


E.8.3 Terminating an 1/0 Exercise and Restarting IOX 


The ABORT command terminates the execution of an I/O exercise and of a 
task or tasks initiated by the EXECUTE command. 


ABORT with no command qualifier terminates the execution of an I/O 
exercise before normal completion. 


ABORT with a task name terminates the execution of a task initiated by 
the EXECUTE command. For example: 


ABORT ...-BAD 
This command aborts the Bad Block Locator Utility (BAD). 


ABORT /ALL terminates all the tasks initiated by the EXECUTE command 
and removes the tasks from the list of tasks to be executed by IOX. 


The RESTART command directs IOX to: 
@ Deselect and detach all units 
@e Remove all user-configured units 
@ Reset all parameters to default values 


e Return I0X to its original memory size 


E.9 USING INDIRECT COMMAND FILES WITH IOX 


You can use indirect command files with I0OX in command mode. IOx 
accepts only one level of indirect command file; nested indirect 
files are not allowed. 
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You can use indirect command files to set up execution parameters for 
exercises. For example, the file RUN10.IOX contains the following IOX 
commands to set execution parameters: 
LOGFILE YES 
RUNTIME 10 
SUMMARYTIME 1 
CONTROL _C NO 
To execute this indirect command file, you enter the command: 
@RUN1O.IOX 


IOX accesses the file RUN1O.IOX and executes the commands, setting the 
execution-time parameters. 


Comments are allowed on command lines. 


E.10 COMMAND DESCRIPTIONS 

This section provides complete descriptions of IOX commands and _ the 
rules for entering them on command lines. The commands are arranged 
in alphabetical order. 

Notational Conventions 

The paragraphs below describe the notational conventions used in this 
section to define IOX command elements and how to enter them on 
command lines. 

Command Line Elements 

IOX command lines consist of command lines and qualifiers. You can 
abbreviate both the command name and the qualifier using the rule 
described below under "Command Abbreviations." 

There are two types of command qualifiers: one type requires numeric 
settings and the other requires YES/NO settings. 

Default Values for Command Qualifiers 

Where there is a default value for a command qualifier, that value is 
stated explicitly in the command description. 

Use of Uppercase Characters 

Where uppercase characters appear in a command line format, the 
uppercase characters must be entered as they are shown. 

Use of Lowercase Characters 

Lowercase letters, words, or symbols in command line format 
specifications represent variables for which values’ should be 


substituted. For example: 


dduu: 
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These letters represent the values that make up a device 
specification. Values can be substituted for each of these variables 
as appropriate. 
Use of Colons (:) 
Colons are used in device specifications as delimiters. In this case, 
the colon is required. Colons are also used to separate related parts 
of certain command line elements. For example: 

BADBLOCKS DK2: 70:3 
The colon following the device specification is the specification 
delimiter; the colon in 70:3 is the command element separator; it 
means enter a sequence of 3 bad blocks beginning at block 70. 
Command Abbreviations 
Where short forms of commands or qualifiers are allowed, the shortest 
form acceptable is represented by uppercase letters. The following 
example shows the abbreviations allowed for the IOX LOGFILE YES 
command: 

LOgfile Yes 
This notation means that LO, LOG, LOGF, LOGFI, LOGFIL, and LOGFILE and 
Y, YE, and YES are valid specifications for the LOGFILE command. 


Use of Braces ([]) 


Braces are used to denote optional entries in a command line. 


Use of At Sign (@) 


The at sign (@) is used to invoke an indirect command file. The at 
sign precedes the file specification for an indirect command file: 


@filename.filetype; version 


All numeric values are entered in decimal, with the exception of 
device unit numbers and file version numbers. 
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ABORT 


Abort [taskname] 


{ /ALL } 


The ABORT command terminates the execution of an I/O exercise and 
any tasks initiated by the EXECUTE command. 


ABORT with no command qualifier terminates the execution of an 
I/O exercise before normal completion. 


ABORT with a task name terminates the execution of a task 
initiated by the EXECUTE command. For example: 


ABORT ...BAD 
This command aborts the bad block locator utility. 
ABORT /ALL terminates the execution of all the tasks initiated by 


the EXECUTE command and removes the tasks from the list of tasks 
to be executed by IOx. 
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BADBLOCKS 


BAdblocks ddnn: [blocknum:number,...([number,...]...] 


The BADBLOCKS command allows you to enter the block numbers of 
bad blocks on the unit I0X is to test. In the format above, 
number specifies the number of sequential bad blocks beginning at 
the specified block number (blocknum in the format). The colon 
is required when you specify a sequence of bad blocks in this 
form. For example: 


BADBLOCKS DK2: 70:3 


This command enters the block numbers 70, 71, and 72 in the I0Ox 
bad block list. 


You can also specify the address of a single bad block. For 
example: 


BADBLOCKS DK2: 3 
This command enters block 3 in the IOX bad block list. 


You can use both of these forms on the same command line, for 
example: 


BADBLOCKS DK2: 100:2,3,300:100 


This command enters blocks 100, 101, 3, and 300 through 399 in 
the IOX bad block list. 


When you enter only the device name, IOX displays the bad blocks 
in its bad block list. For example: 


BADBLOCKS DK2: 
This command causes IOX to display: 


00070:003 
00100:002 
00003:001 
00300:100 


The first number in the display represents the beginning of the 
sequence of bad blocks; the second number in the display 
represents total bad blocks in a sequence of bad blocks. 


Bad block numbers entered with the IOX BADBLOCKS command are 
temporary and are used only by IOX in its testing. That is, IOX 
ignores the bad blocks recorded by the manufacturer or such 
utilities as BAD; IOX uses only the blocks you enter with the 
BADBLOCKS command. 
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BUFFERSIZE 


BUffersize bytes 
The BUFFERSIZE command changes the size of the buffer I0OX uses 
when exercising units with non-file-structured volumes. I0OX 
stores the specified buffer size in byte form (rounded up to’ the 
next 4-byte boundary) and I0X requests buffers of that size 
dynamically, as necessary. 


This command is not valid if units are currently selected. 


CONFIGURE 


CONFigure [dduu:] 
The CONFIGURE command enters a unit in the test configuration. 
(Units must be configured before they can be selected for testing 
by the SELECT or FILES11 commands.) The CONFIGURE command also 
displays the units in the test configuration. 


CONFIGURE with a qualifier adds a unit to the test configuration. 
For example: 


CONFIGURE DK20: 
This command adds device DK20: to the test configuration. 


CONFIGURE with no qualifiers lists all the devices in the test 
configuration: : 


IOX>CONFIGURE 


DBO: DBl: DB2: DDO: DFO: DKO: DK20: DLO: DMO: DPO: 
DRO: DSO: DxXO: DYO: CTO: DTO: MFO: MMO: MSO: MTO: 


Unit 0 is configured by default. 
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CONTROL_C 


CONTrol_c [Yes] 
[No ] 


The CONTROL_C command enables or disables the use of CTRL/C_ to 
interrupt an I/O exercise. 


CONTROL C YES enables "interruptions to an I/o exercise; 
CONTROL_C NO disables interruptions to an I/O exercise, 


When you set CONTROL _C YES you can interrupt an I/0 exercise to 
enter IOX commands interactively. For example, you can execute 
other tasks by means of the EXECUTE command or abort the I/0 
exercise by means of the IOX ABORT command. 


When you interrupt an exercise with CTRL/C, the exercise 
continues to execute, but error reports and activity reports are 
not displayed at your terminal. Further, CTRL/C causes the I0X 
clock to stop at the next summary interval, even though the 
exercise continues to execute. Therefore, the execution times 
shown in activity reports may not show how long the I/O exercise 
actually executes, 


When you set CONTROL_C NO, the I/O exercise cannot be 
interrupted. When you enter CTRL/C, MCR prompts you and the 
rules for entering commands to MCR apply. The only way to 
terminate the I/0 exercise in this case is to use the MCR ABORT 
command: 


MCR>ABORT IOX 
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DENSITY 


DENSity dduu: [nnnn] 


The DENSITY command sets the tape density and characteristics 
word for IOX to use while testing magnetic tape units. 


Three densities are legal for MT: devices: 
200, 556, and 800 BPI 

Two densities are legal for MM: devices: 
800 and 1600 BPI 

One density is legal for MS: devices: 
1600 BPI 


The device must be specified when setting the density. For 
example: 


IOX>DENS MT: 556 
This command sets the tape density for MT: testing to 556 BPI. 


If you do not specify the density, [(nnnn], but specify the device 
unit, as follows 


IOX>DENS MM: 


IOX displays the current tape density setting and characteristics 
word for MM: devices. For example: 


DENSITY = 800 BPI CHARACTERISTICS WORD = 04004 (OCTAL) 
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DESELECT 


DESelect dduus: 


The DESELECT command terminates testing on the specified device. 
DESELECT terminates I/O operations to the specified unit, deletes 
the bad block list associated with the unit, deassigns the LUN 
for the unit, and detaches the unit from the test configuration. 


The unit remains in the configuration. 


ERRORLIMIT 


ERrorlimit number 


The ERRORLIMIT command sets the number of errors tolerated 
between interval reports before IOX deselects a device because of 
too many errors. For example: 


SUMMARYTIME 2 
ERRORLIMIT 10 


If you request summary reports every two minutes and an error 


limit of 10 errors, IOX allows up to 10 errors on a unit in that 
2-minute interval before deselecting the unit. 


EXECUTE 


EXEcute taskname commandstring 


EXIt 


The EXECUTE command directs a command line to RSX-11M for 
execution. You can enter the EXECUTE command while IOX is in 
command mode or when IOX is in interactive mode. In both cases, 
output directed to your terminal from the spawned task is 
displayed at your terminal whether or not an exercise is 
executing. 


All the rules for entering RSX-11M command lines and the use of 
the SPWNS directive apply to the parameters you enter on the 
EXECUTE command line. 


A practical example of the use of EXECUTE is to run_ the BAD 
utility to list the bad blocks on a volume at your terminal: 


EXE ...BAD DKO:/LI 


This command line invokes the BAD utility, which then lists any 
bad blocks on a volume at your terminal. 


EXIT 


The EXIT command terminates IOX processing and exits from IOX_ to 
the operating system monitor. 


FIL 


File 
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ES11 


sll dduu: filesize 


The FILES11 command selects a unit with a Files-1l volume for an 
I/O exercise. The unit must first be entered in the test 
configuration with the CONFIGURE command. 


The FILES11 command performs the same function as the SELECT 
command. FILES11 is used to select units with Files-1l volumes; 
SELECT is used to select units with non-file-structured volumes. 


An example of the FILES11 command is: 

FILES11 DKl: 1000 
This command selects the unit DKl: for I/O exercising. The 
number 1000 overrides the file size of the temporary file IOX 
uses to process units with Files-1l1 volumes mounted. 
IOX uses a temporary file when it processes units with Files-11l 


volumes. ~ You can set the size of this file with the 
TEMPORARYFILE command. 


HELP 


Help 


The HELP command displays a summary description of IOX commands 
at your terminal. 


INTERLEAVE 


INterleave number 


The INTERLEAVE command specifies the interleave factor (in number 
of blocks) for exercising units. 


When IOX writes the test pattern to disk, it can write the 
pattern to either random blocks or to a specified sequence of 
blocks. You can direct IOX to write to random blocks by entering 
the RANDOM command: 


RANDOM YES 
When you direct IOX to write to a sequence of blocks (RANDOM NO 
is set), use INTERLEAVE to specify the number of blocks to be 
skipped before the next pattern is written. For example: 


RANDOM NO 
INTERLEAVE 2 


In this example, the interleave factor is set to two and I0OX 
writes to and reads from every second block on the disk (block 0, 
block 2, block 4, and so forth) beginning at block 0. For 
DECtapes, the only interleave factor allowed is 4. 


THE RSX-11M I/O EXERCISER 


ITERATIONS 


ITerations number 


The ITERATIONS command specifies the number of times IOX executes 
its idle loop before it counts an iteration through the idle 
loop. For example: 


ITERATIONS 10 


IOX counts one iteration for every 10 times it executes its idle 
loop. 


The ITERATIONS command is used with the WAIT command to measure 
system activity. 


LOGFILE 


Logfile [Yes] 
{ No] 


The LOGFILE command enables you to direct activity reports and 
error reports to either your terminal or to a log file called 
SY0:IOX.LOG. LOGFILE YES directs reports to the log file; 
LOGFILE NO directs reports to your terminal. LOGFILE NO is the 
default. 


Other types of output (from the PRINTSUMMARY command or SPY 
command, for example) are always directed to your terminal. 


IOX notes the time you started the log file and the time you 
completed entering data to it in the activity reports. Once 
IOX.LOG is created, IOX appends data to the end of the file 
without creating new versions of the file. 


Refer to Section E.6, "I/O Exercise Output," for more information 
on how to use the LOGFILE command. 
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PARAMETERLIST 


PARameterlist 


The PARAMETERLIST command displays the settings of the I0OxX 
execution parameters at the time you entered the command. It 
also, displays information on currently selected devices, active 
tasks, and the amount of dynamic memory in use. 


When you enter the PARAMETERLIST command, IOx displays 
information in the following form: 


IOX>PARAMETERLIST 

TASK STATUS COMMAND LINE 

-+eBAD QUEUED DKO:/LI 

DEVICE LUN BUFSIZE TYPE FILESIZE 
DB1l: 5. 512. Fll 500. 
DB2: 6. 512. Fill 500. 
MM1: 7. 1024. NFS 

BUFFERSIZE= 1024. CONTROL C= YES 

ERRORLIMIT= 10. LOGFILE= NO 

INTERLEAVE= 4. RANDOM= YES 

ITERATIONS= 10. REPORTERRORS= YES 

PATTERN= 4. RETRIES= NO 

RUNTIME= 5. VOLUMECHECK= YES 

SUMMARYTIME= 1. WAIT= YES 

TEMPORARYFILE= 500. WRITECHECK= NO 


DYNAMIC MEMORY USAGE= 3278.:2248.:2248.:1. 


For tasks initiated by the EXECUTE command, the 
PARAMETERLIST command displays: 


e The installed task name (...BAD) 


e The execution status (QUEUED, ACTIVE, SUCCESS, WARNING, 
ERROR, SV ERROR) 


e The command line elements you entered (DK0O:/LI) 


ACTIVE indicates that I0X is being executed. The remaining 
status indications relate to Exit with Status (EXSTS) Executive 
directive. For more information on these status indications, 


refer to the RSX-11M/M-PLUS Executive Reference Manual. 


For selected units, PARAMETERLIST displays the following 
information: 


e Device specifications (DBl:, DB2:, and MM1:) 

e Logical Unit Number (LUN) (5, 6, and 7) 

e Buffer size IOX uses for reads and writes (512(10) for 
units with Files-11 volumes mounted; 1024(10) for units 
with non-file-structured volumes) 

e Type of volume mounted on unit (Fll for Files-1l; NFS 


for non-file-structured volumes; VFY for units being 
verified) 
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e File size of the temporary file I0X uses for processing 
units with Files-11 volumes mounted 
The line describing dynamic memory usage is in the form: 
totalmemory: freeblock: freebytes: fragments 


totalmemory 
Indicates the size of IOX dynamic memory in bytes. 


freeblock, 
Indicates the size of the largest free block of I0X dynamic 


memory in bytes. 


bytes 
Indicates total free bytes available in IOX dynamic memory. 


fragments 
Indicates the number of memory fragments in IOX dynamic memory. 
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PATTERN 


PATtern [patternnumber] 


The PATTERN command sets the pattern IOX writes and reads during 


testing. There are 11 patterns, each specified by one of the 
following numbers: 


Pattern 
Number Pattern 


000000,000000 
177777 ,177777 
125252,052525 
165555,133333 * 
163126,163126 
055555,155555 
022222,122222 
111111,111111 
007417 ,007417 
021042,021042 
104210,104210 
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For example: 
PATTERN 3 


This command directs IOX to use the pattern 125252,052525 when it 
writes to units for testing. IOX places an asterisk (*) next to 
the selected pattern when you display the patterns. 


Pattern 4 is the default pattern, 


PRINTSUMMARY 


PRIntsummary 


The PRINTSUMMARY command prints the totals for I/O exercise 
activity between the time of the last interval summary report and 
the time you entered the PRINTSUMMARY command. These totals are 
printed in the form of a summary report displayed at your 
terminal. Section E.6, "I/O Exercise Output," shows the form of 
a print summary report. 


PROCEED 


PROceed 


The PROCEED command is used to resume display of I0OX activity 
reports and error reports at your terminal and to restart the IOx 
clock after these functions have been suspended by CTRL/C. 


CTRL/C suspends activity and error reporting and stops the I0OX 
clock. PROCEED resumes reporting to your terminal and restarts 
the IOX clock. 


i 


+ 
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RANDOM 


RAndom [Yes] 
[No ] 


The RANDOM command directs IOX to use a random number generator 
to choose the blocks on the disk being exercised. RANDOM YES 
directs IOX to use the random number’ generator; RANDOM NO 
directs I0OX to use the number of sequential blocks specified in 
the INTERLEAVE command. 


Refer to the command description of the INTERLEAVE command for 
information on how to use INTERLEAVE. 


REPORTERRORS 


REPorterrors [Yes] 
[No ] 


The REPORTERRORS command enables or disables IOX error reports. 
REPORTERRORS YES directs IOX to report errors; REPORTERRORS NO 
disables error reports. REPORTERRORS YES is the default. 


When you direct IOX to report errors, I0OX directs the error 
reports either to. your terminal or to the log file IOX.LOG, 
depending on how you have set the LOGFILE command. (See the 
command description of LOGFILE for information on how to use 
LOGFILE.) 


IOX error reports have the following form: 


DK1l: -- UNRECOVERABLE ERROR AT BLOCK 358 (DECIMAL) (OCTAL) 
DK1l: -- DATA ERROR AT BLOCK 358 (DECIMAL) (OCTAL) 
GOOD DATA: 165555 BAD DATA: 167155 (OCTAL) 
WORD POSITION: 308 (DECIMAL) 464 (OCTAL) 


RESTART 


REStart 


The RESTART command directs IOX to deselect and detach all units, 
remove all user-configured units, reset all parameters to their 
default values, and return the exerciser task to its original 
memory size. 


RETRIES 


RETries [Yes] 
[No ] 


The RETRIES command directs an I/O driver to either retry or not 
retry an I/O operation after it receives an error on the first 
attempt at the operation. RETRIES is used when exercising units 
with non-file-structured volumes. 
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RUNTIME 


RUntime minutes 


The RUNTIME command specifies the amount of time in minutes’ that 
IOX is to test a unit or units. For example: 


RUNTIME 2 


This command directs IOX to exercise selected devices for two 
minutes. If you specify RUNTIME 0, IOX tests units continuously. 


The default run time is five minutes. 


SELECT 


SElect dduu: ({[(buffsize] 


The SELECT command selects a unit with a non-file-structured 
volume for an I/O exercise. An example of the SELECT command is: 


SELECT DK1l: 2000. 


This command selects unit DK1: for an I/O exercise and specifies 
a buffer size of 2000(10) bytes for IOX processing. 


The unit must be configured with the CONFIGURE command before you 
can select it. 


The SELECT command allows an I/O exercise to destroy all the data 
structures on the mounted volume. To ensure that the mounted 
volume is not a Files-11l volume, enter: 

VOLUMECHECK YES 


If you do not specify the buffsize parameter, the size specified 
in the last BUFFERSIZE command applies. 


The default buffer size is 1024 bytes. 
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SPY 


SPy [dduu:] 
The SPY command displays information describing the current 
status of a unit or units. When you specify no device on the 
command line, the status of all units is displayed. 


SPY displays status information in the following form: 


DBO: -- TYPE=Fll VBN=305. I/O=AST QUEUED FUNCTION=WRITE 
This line indicates: 
@ The unit being exercised (DBO:) 
@ The type of volume mounted on the unit (Files-1l) 
® The Virtual Block Number being tested 305(10). (This 
would be the Logical Block Number (LBN) for an 
unformatted volume) 


e I/0 request status: AST QUEUED, IN PROGRESS, or IDLE 


e The type of I/O function being performed (WRITE) 


START 


STart 
The START command starts execution of an I/O exercise on units 
selected by the FILES11 command and the SELECT command. Refer to 
Section E.3, "Installing, Invoking, and Running IOX in an 


Exercise Example," for information on how to use the START 
command. 


SUMMARYTIME 


SUmmarytime [minutes] 


The SUMMARYTIME command specifies the time interval in minutes 
between interval summary reports. For example: 


SUMMARYTIME 15 


This command specifies that you want a summary report generated 
every 15 minutes. 


A value of 0 specifies that you want no summary reports. 


The default for the interval between summary reports is 1 minute. 
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TEMPORARYFILE 


TEmporaryfile [filesize] 


The TEMPORARYFILE command is used when you want to exercise a 
unit with a Files-11 volume mounted. TEMPORARYFILE specifies the 
size in blocks of the temporary file I0OX uses when it tests 
file-structured devices, This file is marked for deletion when 
IOX exits. Thus, if IOX terminates prematurely, your file 
structure is not corrupted with temporary files used by IOX. 


VERIFY 


VErify dduu: [blocks] 


The VERIFY command is used with units that have 
non-file-structured volumes mounted. VERIFY ensures that a 
device is performing I/O correctly by reading the number of 
blocks (Specified by the blocks parameter) from the specified 
unit. 


IOX performs no pattern checking with VERIFY; that is, no I/0 
exercise is performed. 


VOLUMECHECK 


VOlumecheck [Yes] 
[No ] 


The VOLUMECHECK command enables or disables a check by I0X to 
determine whether or not a unit being tested as 
non=file-structured has a home block. If you check for the home 
block and I0xX finds a home block on the unit, IOX issues a 
message warning you that the unit has a Files-11 volume mounted 
and you may be destroying vital information. 


The default is VOLUMECHECK YES. 
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WAIT 


WAit [Yes] 
[No ] 


The WAIT command is used with the ITERATIONS command to measure 
system activity. IOX executes an idle loop while it waits for 
you to enter a command. It can execute either one of the 
following in this loop: 


1. The wait-for-event-flag algorithm 
2. The instruction 
BICB -(SP),(SP)+ 


The BICB instruction takes up a large amount of CPU time and can 
be used to measure I/O throughput. 


The wait-for-event-flag algorithm is the default, but you can 
disable it and execute the BICB instruction by entering the 
command 


WAIT NO 


Refer to Section E.5.4, "Setting Execution Conditions for 
Measuring System Activity," for information on how to use the 
WAIT command. 


WRITECHECK 


WRitecheck [Yes] 
[NO ] 


THE WRITECHECK command enables or disables write checks by I/0 
drivers when they perform I/O during an I/O exercise. WRITECHECK 
is used to exercise units with non-file-structured volumes. 
WRITECHECK YES directs’ the I/O driver to perform write checks; 
WRITECHECK NO directs the I/O driver to disable write checks. 


When an I/O driver performs an I/O operation, it issues’ three 


instructions: WRITE, WRITE CHECK, and READ. By eliminating one 
of these I/O operations, you can increase the speed of the I/0 
exercise. 


The default is WRITECHECK NO. 
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E.11 I0X MESSAGES 

IOX displays the following messages. When it can determine that a 
specific device unit is involved, IOX also displays the device unit. 
dduu: -- BAD BLOCK, XXX (DECIMAL) XXX (OCTAL) 


Explanation: The error code returned to IOX was IE.BBE (bad block 
error). 


User Action: Use the BADBLOCKS command to enter that bad _ block 
into the IOX bad block list. 


dduu: -- DATA ERROR AT BLOCK XXX (DECIMAL) XXX (OCTAL) 
GOOD DATA: XXXXXX BAD DATA: XXXXXX (OCTAL) 
WORD POSITION: XXX (DECIMAL) XXX (OCTAL) 
Explanation: IOX found an error when comparing the read data with 
the written data. The position of the word within the IOX data 
buffer is shown along with the good and bad data. 
User Action: None. If the error persists, enter that block in 
the bad block list by using the BADBLOCKS command (for 
non-file~structured devices only.) 
dduu: -- DATA OVERRUN AT BLOCK XXX (DECIMAL) XXX (OCTAL) 
Explanation: IOX received an error return of IE.DAO. The record 
size given was greater than that read. This error occurs on tape 
devices only. 


User Action: None. 


dduu: -- END OF VOLUME SEEN 


Explanation: IOX attempted to write a record past the end of tape 
marker. 


User Action: None. 


dduu: -- ERROR THRESHOLD EXCEEDED 


Explanation: The number of errors set with the ERRORLIMIT command 
has been exceeded. 


User Action: None. This is an information message only. IOXx 
deselects the unit and continues testing the other devices. 


dduu: -- FAILED TO DETACH UNIT 


Explanation: This error is extremely rare because IOX detaches 
all units that it has attached and only those units. 


User Action: None. This is a possible operating system problem. 
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dduu: -- FATAL HARDWARE ERROR 


Explanation: The IE.FHE (fatal hardware error) I/O error code was 
returned to IOX. IOX could not recover from the error. 


User Action: Check the hardware. 


dduu: -- I/0 REQUEST ABORTED 


Explanation: The IE.ABO I/O error code was returned to IOX. The 
QIO to the device failed. 


User Action: None. If the problem persists, check the system 
code (Executive or driver). 

dduu: -- I/O UNSATISFIED AT TIMEOUT -— FUNCTION: XXXX 
Explanation: When IOX finishes processing, it waits five seconds 
for I/0 to stop. If a long tape is rewinding, this message may 
occur. XXXX is the function that timed out: READ, WRITE, or 
REWIND. 


User Action: None. 


dduu: -- NO RESPONSE 
Explanation: Unit did not respond to IOX command within one 
minute. The device may have been accidentally put offline or a 
tape drive may have lost its column vacuum. 


User Action: Check the device. 


dduu: -- NOT READY 
Explanation: The unit is not ready. 


User Action: Check the device. 


dduu: -- OFF-LINE 
Explanation: The unit is offline. 


User Action: Check the unit. 


dduu: -- PRIVILEGE VIOLATION 


Explanation: The device was not allocated or was mounted by 
someone else, 


User Action: Check the ownership of the device. 
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dduu: -- UNIT CONTAINS FILE STRUCTURED VOLUME 
Explanation: The VOLUMECHECK command found that the unit is file 
structured because the file contains a home block. You are not 
allowed to use the SELECT command on this unit. 
User Action: IOX destroys information on non-file-structured 
volumes, Make certain that you really want this unit tested as a 
non-file-structured volume. 


dduu: -- UNIT NOT MOUNTED FOR NFS OPERATIONS 


Explanation: You tried to issue a command for a 
non-file-structured device to a file-structured device. 


User Action: Check the device configuration and reissue the 
command. 
dduu: -- UNEXPECTED ERROR XX 


Explanation: IOX received an error code that it could not 
process. XX is the error code. 


User Action: None. 


dduu: -- UNEXPECTED REQUEST TO QUEUE I/O - REQUEST ABORTED 


Explanation: IOX receives an AST from a device after it has 
deselected the device. 


User Action: Check the device. 


dduu: -- UNRECOVERABLE ERROR AT BLOCK XXX (DECIMAL) XXX (OCTAL) 


Explanation: IOX received an IE.VER code from the driver. This 
code indicates an unrecoverable error. 


User Action: Check the device and the media. 


dduu: -- VERIFICATION COMPLETE 


Explanation: This is an information message. The operation of 
the VERIFY command has completed. 


User Action: None. 


dduu: -- WRITE-LOCKED 
Explanation: The device is write-locked. 


User Action: Check the device write-lock/write-enable switch. 


dduu: -- WRITECHECK ERROR AT BLOCK XXX (DECIMAL) XXX (OCTAL) 
Explanation: The write check operation failed at block Xxx. 


User Action: None. 
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IOx -- "@" SYNTAX ERROR 
Explanation: There is an error in the indirect command file. 
User Action: Check the indirect command file. 

IOX -- "@" NESTING LEVEL EXCEEDED 
Explanation: Only one level of nesting is allowed in an indirect 
command file. 
User Action: Check that the indirect command file has only one 
level of nesting. 

IOX -- ABORTING DUE TO MCR/PDS COMMAND OR DIRECTIVE 
Explanation: IOX was aborted from an external source, but did the 
necessary housekeeping before exiting. 
User Action: Restart IOX. 

IOX -- BUFFER SIZE GREATER THAN DEFAULT 
Explanation: The buffer size used in the SELECT command is 
greater than the default buffer size in the BUFFERSIZE command. 
User Action: Respecify the SELECT command. 

IOX -- COMMAND NOT SUPPORTED 
Explanation: This error indicates an attempted execution of the 
EXECUTE command on a system that did not have the SPAWN directive 
in the Executive. 
User Action: You may have to do another system generation to get 
the SPAWN directive into your Executive. 

LOX -~- COMMAND I/0 ERROR 
Explanation: IOX detected an error when it tried to read the 
command that you were typing in at the terminal. 
User Action: Retype the command. 

IOX -- COMMAND VALID ONLY AFTER ABORT 


Explanation: You tried to enter a command that cannot be entered 
while IOX is running. These commands are: RUNTIME, 
PATTERN, RESTART, and START. 


User Action: 


Enter these commands in command mode. 


BUFFERSIZE, 
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IOX -- COMMAND NOT UNIQUE 


Explanation: The command abbreviation that you entered was not 
sufficient to distinguish it from another command. 


User Action: Reenter the command with more letters. 


IOX -- DRIVER NOT LOADED 


Explanation: IOX tried to attach a device which had an unloaded 
driver. 


User Action: Load the driver. 


IOX -- DUPLICATE BLOCK NUMBER 


Explanation: The block number that you entered with the BADBLOCKS 
command is already in the bad blocks list. 


User Action: Reenter the command. 


IOX -- ERROR ATTEMPTING TO READ HOME BLOCK 
Explanation: When the VOLUMECHECK command has been given, this 
error occurs if IOX reads a home block or has an error trying to 
read a home block. The error indicates that IOX has found a 
file-structured volume and may destroy the information on it. 
User Action: Stop IOX and check the disk that you have mounted on 
that device unit. 

IOX -- FAILED TO OPEN TEMPORARY FILE ON dduu: 
Explanation: IOX could not find the necessary number of blocks on 
the disk as specified in the FILES11 command or the TEMPORARYFILE 
command. 


User Actions: Specify a smaller file size. 


IOX -- FAILED TO OPEN "@" FILE 
Explanations: GCML failed to open the indirect command file. 


User Action: Make sure that the file exists and reenter the 
indirect command file. 


IOX -- FAILED TO OPEN LOG FILE 
Explanation: IOX could not open the log file. 


User Action: The disk may be write protected or may not have 
enough blocks, 
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IOX -- FAILED TO CLOSE LOG FILE 
Explanation: IOX could not close the log file. 


User Actions Check the device. 


IOX -- FAILED TO ATTACH dduu: 
Explanation: IOX could not attach unit. 
User Action: The device may be mounted or someone else attached 
the unit. Make sure that you have allocated the device and that 
it is mounted foreign for RSX-11M-PLUS. For RSX-11M it does not 
have to be mounted. 

IOX -- FATAL FILES ERROR. F.ERR= XXX PC+2= XXX 
Explanation: An error occurred while IOX was trying to issue a 
READS or a WRITES command. F.ERR is the error code in the FDB. 
PC+2 is the location of the error in IOX. IOX immediately exits. 


User Action: Investigate the source of the error in the code. 


IOX -- FATAL ERROR. DSW= XXX PC+2= XXX 
Explanation: A directive issued by IOX did not work. DSW is’ the 
directive status word. PC+2 is the location of the failure in 
IOX. IOX immediately exits. 


User Action: Investigate the source of the error in the code. 


IOX -- FILES OPERATIONS NOT SUPPORTED ON dduu: 


Explanation: You entered a FILES11 command to a volume that is 
not a Files-11 volume. 


User Action: Reenter the command for the correct device or use a 
different command. 
IOX -- ILLEGAL DENSITY 


Explanation: The density that you specified for the device is 
incorrect. The device does not support that density. 


User Action: Reenter the command using a different density or 
device. 

IOX -- ILLEGAL UNIT SPECIFICATION 
Explanation: The syntax of the unit specification is incorrect. 


User Action: Reenter the command. 
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IOX -- INVALID BLOCK NUMBER \ 
Explanation: The block number that you entered for the BADBLOCKS 
command was not a valid block number for that device. 
User Action: Reenter the command using a different block number. 

IOX -- INVALID TASK NAME 
Explanation: The task name that you entered is invalid. That is, 
the task name is incorrect, the task does not exist, or the task 
is not installed. : 
User Action: Reenter the task name or determine whether the task 
exists or is installed. 

IOX -- INVALID PATTERN NUMBER 
Explanation: You tried to set a data pattern for IOX to use _ for 
I/O testing that IOX did not recognize. 
User Action: Check the PATTERN command and reenter the correct 
data pattern. 

IOX -- INVALID COMMAND - TYPE H FOR HELP 
Explanation: You entered a command that IOX did not recognize. 
User Action: Enter H (for help) and I0X displays all of its 
commands. 

IOX -- NO BUFFER SPACE 
Explanation: IOX could not extend to make room for a_ needed 
larger buffer, 
User Action: Reinstall IOx with a larger increment. 

ITOX -- NO LUNS AVAILABLE 
Explanation: This is an unlikely message because IOX allows 250 
devices. Unless you have more than 250 devices, this message may 
indicate a system problem. 
User Action: If you have less than 250 devices, call your 
software specialist. 

IOX -- NO ACTIVITY REMAINS - ABORTING 


Explanation: All disk testing and all tasks are finished before 
the run time has expired. 


User Action: None. 
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IOX -- NO ACTIVITY TO START 


IOX 


IOX 


TOX 


IOX 


TOX 


Explanation: You issued the START command without defining the 
configuration or units to exercise. 


User Action: Configure and define the devices that you want to 
exercise. 

-- ONLY “C ALLOWED 
Explanation: You previously entered the CONTROL_C YES command to 
enable interruptions to IOX. Therefore, IOX does not accept any 


other input but CTRL/C. 


User Action: Enter CTRL/C then enter the command. 


-~ SYNTAX ERROR 


Explanation: The command line that you entered contained a syntax 
error. 


User Action: Reenter the command line. 


-~ TASK NEVER EXECUTED 


Explanation: The task that you tried to abort is not on the list 
of tasks initiated by the EXECUTE command. 


User Action: Check your list of tasks to be initiated by the 
EXECUTE command. 
-~- TASK "XXXXXX" CURRENTLY ACTIVE 


Explanation: You tried to execute a task that was already active. 
XXXXXX is the task name. 


User Action: None. 


-- TASK "XXXXXX" EXECUTION COMPLETE. STATUS= NNNNNN 


Explanation: The task completed execution. XXXXXX is the task 
name. NNNNNN is the task status. 


User Action: None. 


IOX 


IOX 


IOxX 


ITOX 


IOX 
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-- TASK "XXXXXX" NOT INSTALLED 


Explanation: The task name "XXXXXX" is not installed and cannot 
be executed as requested. 


User Action: Install the task. 


-- TASK "XXXXXX" UNABLE TO EXECUTE 


Explanations: IOX could not execute the task within a specified 
time. 


User Action: Try to reexecute the task. 


-- UNABLE TO ASSIGN LUN TO dduu: 


Explanation: You tried to access a unit that is not on the 
system. 


User Action: Check the system configuration. 


-- UNIT NOT A MAGTAPE 


Explanation: You tried to issue a DENSITY command to a device 
that is not a magnetic tape device. 


User Action: Reissue the command. 


-- UNIT NOT SELECTED 


Explanation: You issued a device-dependent command to a device 
that you have not selected with the SELECT command or the FILES11 
command. 


User Action: Determine which device you want to affect and select 
it with the SELECT or FILES-11 command. 


IOX - UNIT IS FILE STRUCTURED 


Explanation: You used the BADBLOCKS command to try to create a 
bad blocks list on a file-structured volume. The command did not 
execute, 


User Action: Make certain that you really want IOX to write on 
this device. 


IOX ~-- UNIT ALREADY CONFIGURED 


Explanation: You tried to configure a unit with the CONFIGURE 
command that is already in the configuration. 


User Action: Check the IOX device configuration. 


be 
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IOX -- UNIT NOT CONFIGURED 


Explanation: You tried to access a unit that is not in the I0OX 
unit configuration. 


User Action: Configure the unit using the CONFIGURE command. 


IOX -- UNIT ALREADY SELECTED 


Explanation: You tried to select a unit that has already been 
selected. 


User Action: Check the printout to find which units you have 
previously selected. 


IOX -- UNITS ARE SELECTED - COMMAND IGNORED 


Explanation: The BUFFERSIZE command is valid only if no units are 
selected by either the FILES11 or SELECT command. 


User Action: Deselect all selected units. 


E.11.1 IOX Task Builder Command File 


IOX is built with the defaults that it needs to perform its required 
functions. The Overlay Description Language (ODL) file for IOX 
resides on UIC [1,20] on the system disk. If you want to rebuild I0X 
with different defaults, you can create a Task Builder command file 
like the one the system uses, which is shown below, and put it on UIC 
[1,24] for a mapped system or UIC [1.20] for an unmapped system. 
These UICs are RSX-11M-PLUS/RSX-11M system conventions. 


The system command file for building IOX puts the IOX task on system 
uIc [1,54] for a mapped system; the UIC for system tasks on an 
unmapped system is [1,50]. The command file is shown as inline code 
with commentary. 


(The RSX-11M Task Builder and the ODL are described in the 
RSX-11M/M-PLUS Task Builder Manual.) 


7 
; BUILD MAPPED I/O EXERCISER V14 


c 

[1,54] IOX/FU/CP/MM, [1,34] IOX/-SP/CR/MA/-SH= [1,20] IOXBLD/MP 
STACK=96 

ASG=TI:1:2:4:5:6,SY0:3 

PRI=50 

TASK=,..10X 

PAR=GEN 

NOW DEFINE THE MAXIMUM AMOUNT OF UNITS YOU WILL EVER WANT TO 
TEST. THE MAXIMUM IS 250 AND THE DEFAULT IS 32. 


Cote se te 


NITS=32 
INHIBIT USER OF UNUSED FCS READ/WRITE LONG CODE. 


BLDEF=..RWLG:0 


we G) se se te 
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; THE DEFAULT TEMPORARY FILE STRUCTURED BLOCK SIZE IS 

; DEFINED HERE. THE NORMAL DEFAULT IS 500 DECIMAL (764 OCTAL) ay 
GBLDEF=F11S1Z: 764 

? 

; NOW WE WILL DEFINE THE DEFAULT 2-WORD PATTERN WHICH WILL BE 

; USED TO FILL THE WRITE BUFFER. THE VALUE MUST BE BETWEEN 1 AND 13. ; 
+ THE VALUES CORRESPOND TO THE FOLLOWING PATTERNS: * 
Z 1 -- 000000,000000 

; 2 -- 177777,177777 

; 3 -- 125252,052525 

: 4 -- 165555.133333 

; 5 -- 163126,163126 Z 
; 6 -- 055555,155555 

: 7 -- 022222,122222 

; 10 -= 111111,111111 

; 11 -- 007417,007417 

: 12 -- 021042,021042 

; 13 -- 104210,104210 

7 

GBLDEF=PATERN: 4 

7 NOW WE WILL DEFINE THE CHARACTERISTICS USED FOR MAGTAPE TESTING. : 7 
; THE DEFAULT FOR TU1O IS CORE DUMP MODE; FOR ALL OTHERS IT IS 

; 1600 BPI MODE. SEE THE I/O DRIVERS REFERENCE MANUAL FOR FURTHER 

; INFORMATION CONCERNING THIS VALUE. 

7 

GBLDEF=MAGSTC:004004 

i 

3; NOW DEFINE THE DEFAULT TEST RUNTIME. 

7 

GBLDEF=RUNTIM:5 ame, 
i 4 

7 NOW DEFINE THE DEFAULT INTERVAL BETWEEN SUMMARY REPORTS. 

i 

GBLDEF=SUMARY:1 

i 

; NOW DEFINE THE ERROR THRESHOLD. THIS IS THE NUMBER OF ERRORS 

3; PERMITTED BETWEEN SUMMARY REPORTS BEFORE THE UNIT WILL BE DE-SELECTED. 
GBLDEF=ERRMAX : 12 

? 

+ NOW DEFINE THE NUMBER OF ITERATIONS THAT WILL BE MADE IN THE an, 
; BACKGROUND LOOP BEFORE A ITERATION IS COUNTED. a, 
; 

GBLDEF=ITRCNT:12 

i 

; NOW DEFINE THE INTERLEAVE FACTOR THAT IS USED FOR SEQUENTIAL 

7; NON-FILE STRUCTURED DISK OPERATIONS. 

i 

GBLDEF=INTRLV: 4 

i 

7 NOW DEFINE THE DEFAULT NAME FOR THE EXERCISER. THIS NAME IS IN # 
; RAD50O AND IS USUALLY "IOX". 

; 

GBLDEF=IOXNAM:035260 

7 

; NOW DEFINE THE DEFAULT NON-FILE STRUCTURED BYTE COUNT. THIS IS USED os 
; FOR ALL NON-FILE STRUCTURED DEVICES EXCEPT DECTAPE. THE USUAL VALUE . 
7 IS 2 BLOCKS (2000(8) BYTES). 

7 

GBLDEF=PABCNT: 2000 


=e 


NOW WE WILL DEFINE THE UNSOLICITED AST CHARACTER. THIS IS THE cack 


BLDEF=SCC:3 


me Ne te we GTS we Me 


GBLDEF=REPORT:1 
GBLDEF=RANDOM:1 
GBLDEF=CONTIN:0 
CaLbeEsenRtesa 
6BLDEF=WAITF:1 
CuLneeeveuenin 
// 


THE RSX-11M I/0 EXERCISER 


CHARACTER WHICH WILL INTERRUPT THE EXERCISER WHEN THE ‘CONTROL_C' 
FEATURE IS ENABLED. THE DEFAULT CHARACTER IS CONTROL/C. 


NOW WE WILL DEFINE SOME DEFAULT YES/NO VALUES. 
A VALUE OF "0" SIGNIFIES "NO"; A VALUE OF "1" SIGNIFIES "YES". 


#REPORT ERRORS TO CONSOLE 

;USE RANDOM DISK SEEKS 

7DO NOT RUN CONTINUOUS 

;USE UNSOLICITED AST'S 

;"WAIT" INSTRUCTION IN BACKGROUND LOOP 


;FILE STRUCTURED VOLUME CHECKING 


APPENDIX F 


SYSTEM CONVENTIONS 


F.1 RSX-11M UIC CONVENTIONS 


The RSX-11M Release 3.2 distribution kits observe a set of UIC 
conventions for files on disk. The purpose of these conventions is to 
provide a uniform and consistent means of allocating, locating, and 
maintaining files on disk. 


On a disk, there are many User File Directories (UFDs) in which files 
are catalogued. A particular UFD is referenced by specifying the 
correct UIC (User Identification Code). The UIC consists of two 
numbers separated by a comma and enclosed in brackets (such as UIC 
{11,20]). The first number (11) is the group number; the second 
number (20) is the member number, which indicates a specific directory 
within a group of directories. RSX-11M makes use of the UICsS to keep 
related files in specific directories, 


F.1.1 Group Number 


The group number is used to identify groups of directories. By 
convention, group numbers of 1 through 10 are reserved for access by 
the Executive. At present, only group number 1 is used. It is used 
to identify UFDs which contain files relevant to an RSX-11M system. 
Group numbers 11-377(8) may be used for user files. Please note, 
however, that group numbers 11-27(8) are reserved by DIGITAL for 
storing files relevant to the Executive and Ancillary Control 
Processors (ACP). 


Group Number 11 is used for Executive files 
12 is used for MCR files 


In addition, group numbers 30-177(8) are reserved for DEC-supplied 
software tasks. The distribution kit only uses group numbers 1, 11, 
12, 13, 15, 45, and 200. 


Group number 15 is used for privileged utility tasks 
(PMD, RMDEMO, etc.) 

Group number 45 is used for K-series files 

Group number 200 is used for SYSGEN indirect command files 


SYSTEM CONVENTIONS 


F.1.2 Member Number 


The second number (member number) is used to hold different file types 
of the group. For example, the UIC [11,10] contains source modules of 
the Executive. Member numbers currently in use are: 


10 - Source modules. 


20 - Object modules, assembly and task build command 
files, object module libraries, overlay descriptor 
files for the Executive and all unmapped 
privileged and nonprivileged tasks. 


24 - Same as 20 above, except that files are for mapped 
privileged and nonprivileged tasks, and the 
Executive. 

30 - Listing and map files for all unmapped privileged 


and nonprivileged tasks. 


34 - Listing and map files for all mapped privileged 
and nonprivileged tasks. 


40 - SLP correction files for files located under 
member number 10. 


50 ~ Tasks and Executive for RSX-11M unmapped system. 
54 - Tasks and Executive for RSX-11M mapped system. 
60 7 Tasks and Executive for RSX-11S unmapped system, 
64 = Tasks and Executive for RSX-11S mapped system. 
200 - SYSGEN indirect command files. 


Member numbers 50, 54, 60, and 64 exist only for group number 1. 
Member numbers 10 and 40 exist only for group numbers above 10. 
Member numbers 20, 24, 30, and 34 exist for all group numbers. Member 
number 200 is used exclusively with group number 200. 


For example, for MCR: 
{12,10] Source files. 


[12,20] Unmapped object modules, assembly command files 
and library build command file. 


[12,24] Mapped object modules, assembly command files and 
library build command file. 

[12,30] Unmapped listing files. 

[12,34] Mapped listing files. 


{12,40] SLP correction files for files under [12,10]. 


SYSTEM CONVENTIONS 


For the unmapped system: 


[1,20] Object module libraries, task build command files, 
and Task Builder overlay description files for all 
tasks. 

[1,30] Area for task maps. 

[1,50] RSX-11M Executive and system tasks. 


For the mapped system: 


{1,20] Object module libraries, all task build overlay 
descriptor files for all nonprivileged tasks. 


{1,24] Object module libraries, task build command files 
for all mapped tasks, and overlay description 
files for all privileged tasks. 

[1,34] Executive and task maps. 


(1,54] RSX-11M Executive and system tasks. 


Other UICs: 


F.2 


{1,1] System and macro object module libraries. 
{1,2} System message files. 

[1,3] Directory for lost files found by VFY. 

[1,4] Directory for Post-Mortem and Snapshot Dumps. 
{1,6] Directory for error log files. 

{1,51] Standalone DSC 


NAMING CONVENTIONS 


System file names have the following general format: 


pppnnnsss.typ 


where: 


PPP 


nnn 


sss 


is an optional prefix used to designate a special version or 
characteristic of the named file. The designation BIG, for 
example, is sometimes used to designate a task, such as TKB, that 
is built to operate in more than 8K of memory, e.g., BIGTKB. 


is the system identification for the task. Table F-1 lists all 
system tasks, together with the identification and group codes. 


is a suffix for noting the relationship of the file to the task 
specified in the nnn identification. For example, PIPBLD.CMD is 
the command file for building PIP. 


Suffixes: 
ASM -- Assembly command file 
BLD -- Task Builder command or overlay description file 


SYSTEM CONVENTIONS 


typ is the standard mnemonic for file type, such as MAP, CMD, etc. 


Types: 
CMD - Command File 
DAT - Data files 
LST - MACRO-11 Listing File 
MAC - MACRO-11 Source File 
MAP - Task Map File 
MLB - User Macro Library File 
OBJ - MACRO-11 Object Library File 
ODL - Overlay Description File 
OLB - Object Library File 
PMD —- Post-Mortem or Snapshot Dump File 
SML - System Macro Library File 
STB - Task Symbol Table File 
TSK - Task/Driver Image File 
Table F-1l 
System Identification Codes 
System Group 
ID Code Description 
RSX 11 RSX-11M/S Executive, drivers, and tables 
MCR 12 Monitor Console Routines 
FCP 13 Files-11 Ancillary Control Processor (ACP) 
RMD 14 RMDEMO 
PMD 15 Post-Mortem and Snap-Dump Processor 
BMR 16 Basic MCR (RSX-11S) 
ERL 17 Error Logger 
OTL 20 On-Line Task Loader (RSX-11S) 
SIP 21 System Image Preservation Program (RSX-11S) 
MTA 22 Magtape ACP 
QMG 25 Queue Manager 
MAC 30 MACRO-11 Assembler 
TKB 31 Task Builder 
PIP 32 Peripheral Interchange Program 
FLX 33 File Transfer Program 
VFY 34 File Structure Verification Program 
DMP 35 File Dump Utility 


(continued on next page) 


System 
ID 
DSC 
EDI 
SLP 
PRESRV 
LBR 
PRT 
ODT, TRACE 
FCS 
PSE,SYE 
CML 
ZAP 
BAD 


DSCS8 


CRF 
VMR 
BRU 
UMD 
FTB 
CMP 
PAT 
FMT 
IOxX 
CDA 


LPP 


Group 
Code 
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Table F-1 (Cont.) 
System Identification Codes 


Description 


Disk Save and Compress Utility (task version) 


Line Text Editor 

Source Language Input Program 
Volume Preservation Program 
Librarian 

Serial De-spooler 

Online debugging tool, trace 
File Control Services 

Error log formatters 

Command Line Routing 

File Patch Utility Program 
Bad Block Locator Program 


Disk Save and Compress Utility (stand-alone 
version) 


Cross Reference Utility Program 
Virtual MCR Program 
Backup/Restore Utility 

User Mode Diagnostics 

Fast Task Builder 

File Compare Utility 

Object Module Patch Utility 
Online Formatter 

System I/O Exerciser 

Crash Dump Analyzer 


Queue Manager De-spooler 


APPENDIX G 


BUILDING A 4K FCS RESIDENT LIBRARY 


This Appendix documents the method to build a 4K FCS resident 
(FCSRES). 


library 
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BUILDING A 4K FCS RESIDENT LIBRARY 


eTITLE FCSRES = FCS RESIDENT LIBRARY FILE 
eIDENT /17,0/ 


COPYRIGHT 1974, DIGITAL EQUIPMENT CORP,, MAYNARD, MASS, 


THIS SOFTWARE IS FURNISHED TO PURCHASER UNDER A LICENSE FOR USE 
ON A SINGLE COMPUTER SYSTEM ANDO CAN BE COPIED (WITH INCLUSION 
OF DEC*S COPYRIGHT NOTICE) ONLY FOR USE IN SUCH SYSTEM, EXCEPT 
AS MAY OTHERWISE BE PROVIDED IN WRITING BY DEC, 


THE INFORMATION - IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
NUTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
EQUIPMENT CORPORATION, 


DEC ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY 
OF JTS SOFTWARE ON EQUIPMENT WHICH 15 NOT SUPPLIED BY DEC, 


MODIFIED? 


SROL7 = COMMENT OUT ENTRY POINTS, TO RESTORE DEFAULT 
FCSRES TO BELOW 4k, 

SRO{B = INSERT CALLS OF ARITH AND DARITH ROUTINES TO 
CORRECT PSECT PROBLEM, 


THIS FILE DOCUMENTS HOW TO BUILO AN FCS RESIDENT LIBRARY, 
AND IT DEFINES ALL OF THE POSSIBLE MODULES THAT MIGHT Go INTO 
SUCH A LIBRARY, 


IT SHOULD BE UNDERSTOOD THAT PRECISELY HOW MUCH GOES INTO FCSRES 

1S ACTUALLY DEPENDENT ON WHICH PROGRAMS ARE GOING TO USE IT AND WHAT 
THOSE PROGRAMS REQUIRE, THE IMPORTANT POINT TO BEAR IN MIND 

TS THAT A PROGRAM LINKING TO FCSRES MAY NOT GET MISSING FCS MODULES 
FROM THE SYSLIB,OLB OBJECT LIBRARY FILE AS WELL, A PROGRAM NEEDING 
FCS MODULES WHICH WERE NOT PLACED IN FCSRES WOULD HAVE NO CHOICE 

BUT TO LINK WITHOUT FCSRES AND USE ALL THE MUDULES OUT OF SYSLIB. 


FOR THE OBVIOUS REASONS OF SIZE+ THE MINIMUM AMOUNT SHOULD BE PUT IN 
FCSRES CONSESTENT WITH THE NEEDS OF THE PROGRAMS USING IT, 


THOSE ENTRY POINTS THAT ARE INVOKED BY MACROS ARE DOCUMENTED BELOW 
SO TRAT IT IS POSSIBLE TO PICK WHAT SHOULD GU INTO FCSRES, 


It Is INTENDED THAT THIS FILE BE EDITED TO ELIMINATE UNDESIRED 
MODULES FROM FCSRES. 


THE ACTUAL BUILDING OF FCSRES INVOLVES THE FOLLOWING? 
1) ASSEMBLE THIS MODULE 


MAC> FCSRES-FCSRES=FCSRES 
2) BUILD THE LIBRARY 
SET /UICa(1, 1) 
7O BUILD FCSRES FOR A MAPPED SYSTEMS 


TKB> (1/1) FCSRES/@HD/MM/PT,LP8,SY¥8 (ipl) FCSRES= (200,200) FCSRES 
TKB>/ 

TKB>STACKSO 

TKB>PARSFCSRES 20120000 

TKB// 


TO BUILD AN FCSRES ON AN UNMAPPED SYSTEMS 


TKB>SYE (1, 1] FCSRES/#HO/=MM/PI,LP3,Svi [1,1] FCSRES= (200,200) FCSRES 
TKB>/ 

TKB>STACKE@ 

TKB>PAREFCSRES3 140000320000 

TKB>// 


rz 


‘a. 


rt Y 


BUILDING A 4K FCS RESIDENT LIBRARY 


eMCALL CALLR 
ePSECT $$RESL 


3 
y OPENING FILES 
? 


oGLOBL OPEN sOPENSX, OPNSSX, OPNTSX 
eOPFTIOSICALLR OPEN yOFJDSX CAN USE THE OPENSX CODE 
eGLOBL ,OPFNB sOFNBSX = USED FOR FORTAN RUN TIME 


' 
+ CLOSING FILES 
»GLOBL ,CLOSE sCLOSES$ 


U 
s RECORD I/0 
U 


eGLOBL ,GET,,PUT sGET$, AND PUTS, GETSR, AND PUTSR 
oPUTSOTSCALLR oPUT sPUT$SS CAN USE PUTS CODE 
eGETSQrsCALLR GET sGETSS CAN USE GETS CODE 


: ARITH AND DARITH ROUTINES NECESSARY FOR GETS AND PUTS 

‘ eGLOBL S$DIV,SDMUL,SDDIV 3 

; BLOCK I/0 

, eGLOBL ,READ,, WRITE, WAIT yREADS, WRITES, AND WAITS 


U 
+ OELETE FILES 


' 
oGLOBL ,DELET ;DELETS 
eGLOBL = ,MRKDL +USED BY OPNTSL 


+ FILE EXTENSION 
eGLOBL ,EXTND 
$ DIRECTORY OPERATIONS 
eGLOBL FIND, ENTER, @REMOV 
} FILLE POSITIONING 
eGLOBL POINT, MARK 
} ESTABLISH DIRECTORY ID 
eGLOBL ,GTDID,.GTDIR 
} READ AND WRITE FILE STORAGE REGION CELLS 
.GLOBL ,RDFDR, WDFOR, gRFOWN, =WFOWN, .RDFFP, ,WOFFP 


5 
THE FOLLOWING MODULES HAVE BEEN COMMENTED QUT TO REOQUCE THE SIZE OF 


THE DEFAULT FCSRES TO BELOW 4497, YOU MAY RESTORE THEM, BUT ONLY IF 
YUU REMOVE OTHER ,GLOBL STATEMENTS, 
THE FOLLOWING MODULE Is NORMALLY NOT USED, DELETS Ig MUCH MORE COMMON 
eGLOBL .DLFNB ;DELETE BY FILE NAME BLOCK 
RENAME FILE 
eGLOBL ,RENAM 
ISSUE GENERAL GI/O AND SPECIAL MAGTAPE FUNCTION QI/O0S 


eGLOBL ,XOI0,,CTRL 


Be we we Se te we we we we we we te we Se ue te te 


eEND 


APPENDIX H 


HELP TEXT FILES 


Each distribution kit includes a file (HELP.ULB) which consists of 


‘text sources for the MCR Help command. 


For Big Disk kits, HELP.ULB can be found under the UFD [1,2]. 


For Dual RKOS kits, HELP.ULB is contained on the Executive source disk 
(EXCSRC) under the UFD [1,2]. 


For RLO1 kits, HELP.ULB is contained on the utility source disk 
(RLUTIL) under the UFD [1,2]. ; 


The following lists the steps to use the Help support from HELP.ULB: 
1. Log on privileged 


2. Assign the default system device SY: to the pseudo device 
LB:. For example: 


>ASN LB:=SY: 


3. Establish [1,2] as the default UIC for the terminal. For 
example: 


>SET /UIC=[1,2] 
4. Mount the volume that contains HELP.ULB. For example: 
>MOU DK1:EXCSRC 


5. Copy HELP.ULB to the LB: device. For example (continuing 
the DKl: example): 


>PIP /NV=DK1:HELP.ULB 


6. Extract the build module from HELP.ULB and name the _ file 
HELPBUILD.CMD. For example: 


>LBR HELPBUILD.CMD=HELP .ULB/EX :BUILD 
7. j%Initiate the Help build command file. For example: 
>@HELPBUILD 
The Help build command file (HELPBUILD.CMD) permits you to 
build Help support for most of the MCR commands and several 


of the RSX-11M utilities or you can build a skeletal Help 
file. 


HELP TEXT FILES 


8. When the task build completes, you can delete the 
HELPBUILD.CMD and HELP.ULB. For example: 
>PIP HELPBUILD.CMD;*, HELP.ULB;*/DE 


9. Then dismount the volume. For example: 


>DMO DK1: 


files 


ty 


iF 


APPENDIX I 


HARDWARE BOOTSTRAP PROCEDURES 


I.1 HARDWARE BOOTSTRAP ROUTINES 


This section describes the procedures for bootstrapping programs into 
PDP-11 processor memory using the following PDP-11 bootstrap Read-Only 


Memory 
e 


l. 


5. 


6. 


programs: 

The BM792-YB Bootstrap ROM 

The MR11-DB Bootstrap ROM 

The BM873-YA Bootstrap ROM 

The BM873-YB Bootstrap ROM 

The M9301-YA and M9301-YB Bootstrap ROM'Ss 

The M9301-YC Bootstrap ROM (PDP-11/70 processors only) 


The M9301-YF Bootstrap ROM 


RM792-YB Bootstrap ROM 
this procedure to start up the BM792-YB bootstrap ROM: 
Press HALT 
Set the console switches to 173100. 
Press LOAD ADDRESS. 
Enter the address of the Load device in the console switches: 
Device Code 
RK11l Disk 177406 
RF1ll1 Disk 177462 
RP1ll Disk 176716 
TCL1 DECtape 177344 
Lift the HALT key. 


Press START. 


The system then displays on the console terminal the start-up 
sequence. 


HARDWARE BOOTSTRAP PROCEDURES 


I.1.2 MR11-DB Bootstrap ROM 
yy 
Follow this procedure to start up the MR11-DB bootstrap ROM: 
1. Press HALT. 
2. Enter the address of the load device in the console switches: 
Device Code : 
RF1l Disk 173100 
RK11 Disk 173110 
TCll DECtape 173120 
T11l Magtape 173136 = 
RP1ll Disk 173154 
3. Press LOAD ADDRESS. 
4. Lift the HALT key. 
5. Press START. 
re an. 
The system then displays on the console terminal the start-up : 
sequence, 
I.1.3  BM873-YA Bootstrap ROM 
Follow this procedure to start up the BM873-YA bootstrap ROM: 
l. Press HALT. 
| am, 
2. Enter the address of the load device in the console switches: 
| 
Device Code 
RF1l DISK 173000 
RK11 DISK 173010 
TC1l DECTAPE 173030 
TM11 MAGTAPE 173050 
RP1l DISK 173100 
RC1l1 DISK 173144 
KL11/ DL11 173210 am, 
TA1L1 CASSETTE 173230 
PCll PAPERTAPE 173312 
3. Press LOAD ADDRESS. 
4. Lift the HALT key. 
5. Press START. 
The system then displays on the console terminal the start-up 
sequence, 
ai 
i 
a. 


i th 


HARDWARE BOOTSTRAP PROCEDURES 


I.1.4 BM873-YB Bootstrap ROM 


To start up the BM873-YB bootstrap ROM, 


l. 


2. 


3. 


4. 
5. 


The system then 


sequence, 


Press HALT. 


Device 
<RH11/RH70/RSO03/RS04 Disk (unit 0) 


<RH11/RH70/RS03/RS04 Disk (unit in switch 
register) 


RK11 Disk (unit 0) 

RK11 Disk (unit in switch register) 

TCll DECtape (unit 0) 

TM11 Magtape (unit 0) 

RF1l Disk 

RH11/RH70/TMO2/TU16 Magtape (unit 0) 
RH11/RH70 Device Combination (unit zero) 


RH11/RH70 Device Combination (unit in switch 
register) 


RH11/RH70/RP04/RPO05/RP06 Disk (unit 0) 


RH11/RH70/RPO4/RP06 Disk (unit in switch 
register.) 


RP11/RP02/RP03 Disk (unit 0) 

RP11/RP02/RP03 Disk (unit in switch register) 
KL11/DL11 Console Terminal Reader 

TAl11 Cassette (unit zero) 

TA11 Cassette (unit in switch register) 


PCll papertape reader 


Press LOAD ADDRESS. For units other than zero, 
number in switch register. 


Lift the HALT key. 


Press START. 


follow this procedure: 


Enter the address of the load device in the console switches: 


Code 


173000 


173002 
173030 
173032 
173070 
173110 
173136 
173150 
173230 


173232 


173320 


173322 
173350 
173352 
173510 
173524 
173526 
173620 


enter unit 


displays on the console terminal the start-up 
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I.1.5 M9301-YA or M9301-YB Bootstrap ROM 


Follow this procedure to start up either the M9301-YA or the M9301-YB 
bootstrap ROM: 


1. Press the BOOT switch. 


2. In response to the $ prompt on the console terminal, enter 
one of the following 2-letter codes: 


Code Device 

DB RPO4 05/06 DISK M9301-YB ONLY 

DK RK11 DISK 

DP RP1l (RPO02/03) DISK 

DS RSO03/04 DISK M9301-YB ONLY 

DT TCll DECTAPE 

DX RX11l FLOPPY DISK 

cT TA1L1 CASSETTE TAPE 

MC MIXED MASSBUS DEVICE M9301-YB ONLY 
MM TM02/TU16/TU45 MAGTAPE M9301-YB ONLY 
MT TM1L1/TMA11/TMB11/TU1LO MAGTAPE 

PR PC11/PR11 PAPER TAPE READER 

TT KL11/DL11 CONSOLE TERMINAL READER 


The two alphabetic characters may be followed by an optional 
Single octal digit for bootstrapping from units other than 
zero, and terminated by a carriage return. 


The system then displays on the console terminal the start-up 
sequence, 


I.1.6 M9301-YC Bootstrap (PDP-11/70 Only) 


The M9301-YC bootstrap operates only on the PDP-11/70. Perform the 
following steps to use this bootstrap. 


1. Press the HALT switch and set back to the enable position. 


2. Set the START address of 17765000 in the console switches. 


3. Press LOAD ADDRESS, 
4, Set the device unit number in switches 0 through 2. 


5. Set the device code in switches 3 through 6. The device 
codes are: 


Code Device 


TM11/TU10/TSO3 MAGNETIC TAPE 
TC11/TU56 DECTAPE 
RK11/RKO05 DECPACK DISK CARTRIDGE 
RP11/RP02/RP03 DISK PACK 
RH70/TU16/TU45 MAGNETIC TAPE 
RH70/RP04/RP05/RP06 DISK PACK 

0 RH70/RS04/RS03 FIXED HEAD DISK 


PNA BONE 


6. Ensure that switches 7 through 21 are off (down). 


7. Press START. 


J 


HARDWARE BOOTSTRAP PROCEDURES 


The system then displays on the console terminal the start-up 
sequence. 


Before the M9301-YC bootstrap actually boots the system, it performs 
CPU tests, instruction and addressing tests, and memory and cache 
tests. If a hardware failure is detected, and diagnostic program 
halts. The lights contain the ROM address of the HALT. If this 
occurs, call the Digital Field Service Engineer. 


It may, however, be possible to continue with the bootstrap operation 
if the lights contain the address 17773764, which indicates a cache 
failure. To continue in this case, press cont. This is the only case 
in which it is possible to continue bootstrapping after the diagnostic 
detects an error. 


I.1.7 M9301-YF Bootstrap ROM 


The following instructions bootstrap the system by means of the 
M9301-YF console emulator. Refer to the M9301 Bootstrap/Terminator 
Maintenance Manual, for other ways to boot the system with the 
M9301-YF. 


Follow this procedure at the operator's terminal: 
1. Press the console BOOT switch. 


If diagnostics are enabledl, the M9301-YF performs primary 
CPU diagnostics. 


The terminal then displays the contents of RO, R4, SP, and 
RS, respectively; the contents appear as four 16-bit octal 
numbers. Note that pressing the boot switch at this time 
causes PDP-11 systems without console registers to copy the 
PC into R5 before the power-up sequence begins. 


The terminal then displays the prompt $ at the beginning of a 
new line. 


2. In response to the prompt $, type the appropriate device code 
at the terminal, followed by carriage return: 


Code Device 

DBN RP04, RPOS, RPOG, DISK 
DKN RKOS DISK 

DMN RKO6 DISK 

DSN RSO3 OR RSO4 DISK 

DTN TUS6 DECTAPE 

DXN RX01 FLOPPY DISK 

MMN TU1L6 MAGNETIC TAPE 

MTN TU1LO MAGNETIC TAPE 

PR PCll PAPER TAPE READER 
TT DL11 CONSOLE TERMINAL READER 


1 he M9301-YF micro switches must be set to 000 to perform 
diagnostics when using the console emulator to boot the system. If 
the switches are set to 002, the M9301-YF console emulator boots’ the 
system without performing diagnostics. Consult a Digital Field 


Service Engineer or see the M9301 Bootstrap/Terminator Maintenance 
Manual. 


HARDWARE BOOTSTRAP PROCEDURES 


In the list of codes above, n represents the device unit 
number; the only permissible values are 0 through 7. The 
unit number can be omitted if it is 0. 


If diagnostics are enabled, the M9301-YF performs secondary 
CPU and memory diagnostics before booting the system. 


The system then displays on the console terminal the start-up 
sequence. 


Please cut along this line. 


RSX-11M 

System Generation and 
Management Guide 
AA-H625A-TC 


READER'S COMMENTS 


NOTE: This form is for document comments only. DIGITAL will 
use comments submitted on this form at the company's 
discretion. If you require a written reply and are 
eligible to receive one under Software Performance 
Report (SPR) service, submit your comments on an SPR 
form. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Did you find errors in this manual? If so, specify the error and the 
page number. 


Please indicate the type of reader that you most nearly represent. 


Assembly language programmer 
Higher-level language programmer 
Occasional programmer (experienced) 
User with little programming experience 
Student programmer 


OOOOO0 


Other (please specify) 


Name Date 


Organization 


Street 


City. State... Zip Code 
or 


Country 


—- — — — DoNot Tear - Fold Here and Tape — — —- —~ — — — — — — — 


djijgjijtlal! 


BUSINESS REPLY MAIL 


FIRST CLASS PERMIT NO.33 MAYNARD MASS. 


POSTAGE WILL BE PAID BY ADDRESSEE 


RT/C SOFTWARE PUBLICATIONS TW/A14 
DIGITAL EQUIPMENT CORPORATION 

1925 ANDOVER STREET 

TEWKSBURY, MASSACHUSETTS 01876 


— — — — DoNotTear-FoldHeree — — —- — — — SS i es eS SS SS 


a 


No Postage 


Necessary 
if Mailed in the 
United States 


a | “ 
a 
es | ll * 
| 
a 
ee 
= | 
a | 
as | 
es 
as 
- 
| 
-----'l 


| 
i: 
meal 
ao] 
lg < 
oO ew 
[a 
= 
lic = 
t om 
lz ® 
| 


